简述

TransmitFile是一个扩展的 API,它允许在套接字连接上发送一个打开的文件。这使得应用程序可以避免亲自打开文件,重复地在文件执行读入操作,再将读入的那块数据写入套接字。相反,已打开的文件的句柄和套接字连接一起给出的,在套接字上,文件数据的读入和发送都在模式下进行。这就避免了多次的用户/内核模式切换。与linux的sendfile函数类似。

TransmitFile通过已经连接的SOCKET句柄传输文件,使用操作系统的缓冲管理器来接收数据并提供高质量的文件传输。

https://msdn.microsoft.com/en-us/library/windows/desktop/ms740565(v=vs.85).aspx

参数

  • hSocket

    一个连接的套接字句柄。函数将文件数据写向这个套接字。其必须是面向连接(TCP)的SOCKET。如果hFile为NULL,lpTransmitBuffers将被传输
  • hFile

    已打开的文件句柄。由系统内核读取文件数据,可以通过FILE_FLAG_SEQUENTIAL_SCAN提高处理缓存性能。
  • nNumberOfBytesToWrite

    要传送的字节数。0值表示传送整个文件。发生错误时,以已发送数据为准。
  • nNumberOfBytesPerSend

    每次传送的数据块的大小。0值表示使用SOCKET LAYER的默认值。
  • lpOverlapped

    指向OVERLAPPED结构的指针。如果hSocket以打开重叠(默认),可指定这个参数,以实现一个重叠IO操作(异步)。NULL值表示不开启overlapped(重叠) I/O模式。
  • lpTransmitBuffers

    指向TRANSMIT_FILE_BUFFERS结构指针。NULL值表示仅仅传输文件。

    dwFlags

    用于修改TransmitFile函数调用行为的标识。可以包含下表中的定义(在mswscok.h文件中)
标识 含义
TF_DISCONNECT 在所有文件数据已排队等待传输之后,启动传输层断开连接
TF_REUSE_SOCKET 准备要重复使用的socket句柄。 此标志仅在指定了TF_DISCONNECT时有效。
当TransmitFile请求完成时,套接字句柄可以传递到以前用于建立连接的函数调用,例如AcceptEx或ConnectEx。 这种重用是互斥的; 例如,如果为套接字调用了AcceptEx函数,则仅允许重复使用对AcceptEx函数的后续调用,并且不允许对ConnectEx的后续调用。
注意套接字级文件传输受底层传输的行为的影响。 例如,TCP套接字可能受到TCP TIME_WAIT状态的影响,导致TransmitFile调用被延迟。
TF_USE_DEFAULT_WORKER 指示要使用系统的默认线程来处理长 TransmitFile 请求的 Windows 套接字服务提供程序。可以使用以下注册表参数作为 REG_DWORD 调整系统默认线程︰
HKEY_LOCAL_MACHINE\CurrentControlSet\Services\AFD\Parameters\TransmitWorker
TF_USE_SYSTEM_THREAD 指示Windows Sockets服务提供程序使用系统线程来处理长的TransmitFile请求。
TF_USE_KERNEL_APC 指示驱动程序使用内核异步过程调用(APC)而不是工作线程来处理长的TransmitFile请求。 Long TransmitFile请求定义为需要从文件或缓存中进行多次读取的请求; 因此请求取决于文件的大小和发送数据包的指定长度。
使用TF_USE_KERNEL_APC可以提供显着的性能优势。 然而,可能(虽然不太可能),启动上下文TransmitFile的线程正用于大量计算; 这种情况可能会阻止APC发射。 请注意,Winsock内核模式驱动程序使用正常的内核APC,每当线程处于等待状态时启动,这与用户模式APC不同,每当线程处于用户模式启动的警报等待状态时启动。
TF_WRITE_BEHIND 立即完成TransmitFile请求,无待处理。 如果指定此标志并且TransmitFile成功,则数据已被系统接受,但不一定由远程端确认。 不要在指定TF_DISCONNECT和TF_REUSE_SOCKET标志时使用此设置。

示例代码

#include <stdio.h>
#include <stdlib.h> #include <winsock2.h>
#include <ws2tcpip.h>
#pragma comment(lib,"Ws2_32.lib") #include <MSWSock.h>
#pragma comment(lib, "Mswsock.lib ") int main(int c, char** v)
{
if (c != 4) {
printf("用法:%s filename ip port\n", v[0]);
return 0;
} // 创建并初始化winsock数据变量
WSADATA wsaData = { 0 };
int iResult = 0; SOCKET hSocket = INVALID_SOCKET;
int iFamily = AF_INET;
int iType = SOCK_STREAM;
int iProtocol = IPPROTO_TCP; // 初始化 Winsock
iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
if (iResult != 0) {
printf("WSAStartup failed: %d\n", iResult);
return -1;
}
// 打开socket
hSocket = socket(iFamily, iType, iProtocol);
if (hSocket == INVALID_SOCKET) {
printf("socket function failed with error = %d\n", WSAGetLastError());
WSACleanup();
return -2;
}
do {
// 打开文件
HANDLE hFile = CreateFile(v[1], GENERIC_READ, FILE_SHARE_READ, NULL, OPEN_EXISTING, NULL, NULL);
if (hFile == INVALID_HANDLE_VALUE){
iResult = -3;
break;
}
// 获取文件大小
//GetFileSize(hFile, NULL);
LARGE_INTEGER liFileSize;
if (GetFileSizeEx(hFile, &liFileSize) == FALSE) {
iResult = -4;
break;
}
// 设置远程段地址
sockaddr_in remoteAddr;
remoteAddr.sin_family = AF_INET;
//remoteAddr.sin_addr.s_addr = inet_addr(v[2]);
inet_pton(AF_INET, v[2], &remoteAddr.sin_addr);
remoteAddr.sin_port = htons(atoi(v[3])); // 连接到远程端
iResult = connect(hSocket, (SOCKADDR *)& remoteAddr, sizeof(remoteAddr));
if (iResult == SOCKET_ERROR) {
printf("connect function failed with error: %ld\n", WSAGetLastError());
iResult = -5;
break;
}
// 使用TransmitFile发送文件
if (TransmitFile(hSocket, hFile, 0, 0, NULL, NULL, TF_USE_DEFAULT_WORKER) == FALSE) {
printf("TransmitFile function failed with error: %ld\n", WSAGetLastError());
iResult = -6;
break;
}
} while (0);
// 关闭socket
iResult = closesocket(hSocket);
if (iResult == SOCKET_ERROR) {
printf("closesocket failed with error = %d\n", WSAGetLastError());
iResult = -7;
}
// 清理
WSACleanup(); return iResult;
}

TransmitFile函数的简单使用的更多相关文章

  1. Shell函数的简单应用

    Shell函数的简单应用 在脚本内给函数传参: #!/bin/bash . /etc/init.d/functions CheckUrl (){ curl -I -s $ | head - } Che ...

  2. posix 线程(一):线程模型、pthread 系列函数 和 简单多线程服务器端程序

    posix 线程(一):线程模型.pthread 系列函数 和 简单多线程服务器端程序 一.线程有3种模型,分别是N:1用户线程模型,1:1核心线程模型和N:M混合线程模型,posix thread属 ...

  3. c语言中函数的简单介绍

    c语言中函数的介绍: 函数,简单的说就是代码的打包.存放在一个地方,当需要的时候调用. 函数分类: 1.无参无返回值函数 void func() 2.无参有返回值函数  int func() 3.有参 ...

  4. Swift学习之函数和简单地控件的创建

     今天还是重复昨天做的事情--敲代码,但唯一的不同就是所学的知识不同了,我们又进一步往深得层次学习了,感觉越来越有意思了,虽然临近结束了看着大家积极性越来越低了,但是我知道我不能这样,我要比别人付出的 ...

  5. 字符编码知识简介和iconv函数的简单使用

    字符编码知识简介和iconv函数的简单使用 字符编码知识简介 我们知道,在计算机的世界其实只有0和1.期初计算机主要用于科学计算,而我们知道一个数,除了用我们常用对10进制表示,也可以用2进制表示,所 ...

  6. tf.nn.embedding_lookup TensorFlow embedding_lookup 函数最简单实例

    tf.nn.embedding_lookup TensorFlow embedding_lookup 函数最简单实例 #!/usr/bin/env python # -*- coding: utf-8 ...

  7. ffplay.c函数结构简单分析(画图)

    最近重温了一下FFplay的源代码.FFplay是FFmpeg项目提供的播放器示例.尽管FFplay只是一个简单的播放器示例,它的源代码的量也是不少的.之前看代码,主要是集中于某一个"点&q ...

  8. python内置函数的简单使用和介绍

    """内置函数的简单使用和介绍参考链接:https://docs.python.org/3/library/functions.html ""&quo ...

  9. 【JavaScript】使用setInterval()函数作简单的轮询操作

    轮询(Polling)是一种CPU决策怎样提供周边设备服务的方式,又称"程控输出入"(Programmed I/O). 轮询法的概念是.由CPU定时发出询问.依序询问每个周边设备是 ...

随机推荐

  1. jsp的九大内置对象

    九大内置对象 jsp servlet   对象名 类型 使用范围 request HttpServletRequest 请求 浏览器--->服务器 response HttpServletRes ...

  2. SDWebImage的简单使用

    首先,SDWebImage的git地址是:https://github.com/rs/SDWebImage.我们可以直接到这里进行下载,然后添加到自己的项目中去. 一.使用场景(前提是已经导入了SDW ...

  3. js版面向对象图片放大镜

    <!DOCTYPE html><html> <head> <meta charset="UTF-8"> <title>放 ...

  4. shell及脚本4——shell script

    一.格式 1.1 开头 必须以 "# !/bin/bash"  开头,告诉系统这是一个bash shell脚本.注意#与!中间有空格. 二.语法 2.1 数值运算 可以用decla ...

  5. 【hrbust2293】棋盘村

    题意 哈理工2016级新生程序设计全国邀请赛A题 http://acm.hrbust.edu.cn/index.php?m=ProblemSet&a=showProblem&probl ...

  6. 锋利的jquery-读书笔记(一)

    最近转职做前端,学了两个月目前学到jquery的部分,看的是<锋利的jquery>这本书,特地开了博客将自己学习过程中看到的一些知识做一个笔记. 第一章: 一.jQuery对象和DOM对象 ...

  7. python venv下安装mysql出错 解决方法

    1.首先使用exe文件安装python-mysql.链接: http://pan.baidu.com/s/1kVqILTX 密码: manj. 2.虚拟环境创建后,我们把已经在公共环境使用exe安装好 ...

  8. js中this关键字测试集锦

    参考:阮一峰<javascript的this用法>及<JS中this关键字详解> this是Javascript语言的一个关键字它代表函数运行时,自动生成的一个内部对象,只能在 ...

  9. 精通Web Analytics 2.0 (8) 第六章:使用定性数据解答”为什么“的谜团

    精通Web Analytics 2.0 : 用户中心科学与在线统计艺术 第六章:使用定性数据解答"为什么"的谜团 当我走进一家超市,我不希望员工会认出我或重新为我布置商店. 然而, ...

  10. 利用django创建一个投票网站(五)

    创建你的第一个 Django 项目, 第五部分 这一篇从第四部分(en)结尾的地方继续讲起.我们在前几章成功的构建了一个在线投票应用,在这一部分里我们将其创建一些自动化测试. 自动化测试简介 自动化测 ...