GUID
#include <initguid.h> // For DEFINE_GUID
// Device Interface GUID.
DEFINE_GUID(GUID_DEVINTERFACE_FOR_D3XX,
GUID DeviceGUID[2] = {0};
GUID是通过特定算法产生的一个二进制长度为128位的数字,在空间上和时间上具有唯一性,保证同一时间不同地方产生的数字不同。GUID的主要目的是产生完全唯一的数字。在理想情况下,任何计算机和计算机集群都不会生成两个相同的GUID。随机生成两个相同GUID的可能性是非常小的,但并不为0。
用了DEFINE_GUID,你可以使用在所有源文件中包含同一个头文件,在头文件中这样定义GUID:DEFINE_GUID(CLSID_MyObject,0x00000000, 0x0000, 0x0000, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00);
在没有包含Initguid.h的地方,DEFINE_GUID宏创建外部引用来使用GUID值,在包含Initguid.h的地方,DEFINE_GUID重定义DEFINE_GUID宏以产生GUID的定义。
typedef struct _GUID {
unsigned long Data1;
unsigned short Data2;
unsigned short Data3;
unsigned char Data4[ 8 ];
} GUID;
memcpy()
#include<string.h>
// Open a device handle by GUID
memcpy(&DeviceGUID[0], &GUID_DEVINTERFACE_FOR_D3XX, sizeof(GUID));
函数原型:void memcpy( voiddest, const void *src, size_t n );
函数功能:由src指向地址为起始地址的连续n个字节的数据复制到以destin指向地址为起始地址的空间内。
返回值: 函数返回一个指向dest的指针。
主要目的是,使用GUID唯一标识USB设备,并把打开USB设备的句柄存储到GUID的数据结构中。
memcmp()
#include<string.h>
//Compare bytes read with bytes written
memcmp(acWriteBuf, acReadBuf, sizeof(acReadBuf));
函数原型: int memcmp(const void *str1, const void *str2, size_t n)) ;
函数功能:把存储区 str1 和存储区 str2 的前 n 个字节进行比较。
返回值: 如果返回值 < 0,则表示 str1 小于 str2。如果返回值 > 0,则表示 str2 小于 str1。如果返回值 = 0,则表示 str1 等于 str2。
isprint()
#include <ctype.h>
if (!isprint(pManufacturer[i]))
函数原型:int isprint( int c );
函数功能:检查所传的字符是否是可打印的,可打印字符是非控制字符的字符。
返回值: 如果 c 是一个可打印的字符,则该函数返回非零值(true),否则返回 0(false)。
主要目的是,检验输入的参数是否正确。
OVERLAPPED
功能作用:Overlapped I/O的设计的目的:取代多线程功能(多线程存在同步机制,线程上下文切换是十分消耗CPU资源的)。Overlapped I/O模型是OS为你传递数据,完成上下文切换,在处理完之后通知你。由程序本身的处理,变为OS的处理(内部也是用线程处理的)。也就是说程序运行的同时,系统再开辟一个I/O操作的新线程,I/O操作的时间和线程执行其它任务的时间是重叠(OVERLAPPED)的。
// Create the overlapped io event for asynchronous transfer
// Write asynchronously
// When FT_WritePipe is called with overlapped io,
// the function will immediately return with FT_IO_PENDING
程序解读:
因为 FT_WritePipe()是同步阻塞操作,如果要做到异步写操作,就要用到 vOverlapped parameter。
CreateEvent() 创建事件对象,指定该内核对象是自动重置的(FALSE)。并且指定该内核对象起始状态是未通知状态的(FALSE)。
当 FT_WritePipe() 用 overlapped IO 调用时,会立即返回 FT_IO_PENDING 。
进入循环的作用是判断写操作是否完成。通过 FT_GetOverlappedResult() 检测写操作是否完成,若未完成则返回 FT_IO_INCOMPLETE ;写操作线程继续,同时检测线程检测。
最后关闭事件对象。
你可以这样认为重叠IO,现在你已经进入一个服务器/客户机环境,请不要混淆概念,这里的服务器是指操作系统,而客户机是指你的程序(它进行IO操作),是当你进行IO操作(send,recv,writefile,readfile….)时你发送一个IO请求给服务器(操作系统),由服务器来完成你需要的操作,然后你什么事都没有了(有点像开辟新线程),当服务器完成IO请求时它会通知你,当然在这期间你可以做任何事,一个常用的技巧是在发送重叠IO请求后,程序在一个循环中一边调用PeekMessage,TranslateMessage和DispatchMessage更新界面,同时调用 GetOverlappedResult等待服务器完成IO操作,更高效一点的做法是使用IO完成例程来处理服务器(操作系统)返回的结果,但并不是每个支持重叠IO操作的函数都支持完成例程如TransmitFile函数.
OVERLAPPED 数据结构:
typedef struct _OVERLAPPED {
DWORD Internal; //通常被保留,当GetOverlappedResult()传回False并且GatLastError()并非传回ERROR_IO_PENDINO时,该状态置为系统定的状态。
DWORD InternalHigh; //通常被保留,当GetOverlappedResult()传回False时,为被传输数据的长度。
DWORD Offset; //指定文件的位置,从该位置传送数据,文件位置是相对文件开始处的字节偏移量。调用 ReadFile或WriteFile函数之前调用进程设置这个成员,读写命名管道及通信设备时调用进程忽略这个成员;
DWORD OffsetHigh; //指定开始传送数据的字节偏移量的高位字,读写命名管道及通信设备时调用进程忽略这个成员;
HANDLE hEvent; //标识事件,数据传送完成时把它设为信号状态,调用ReadFil,eWriteFile,ConnectNamedPipe TransactNamedPipe函数前,调用进程设置这个成员. 相关函数CreateEvent ResetEvent GetOverlappedResult WaitForSingleObject CWinThread GetLastError
} OVERLAPPED, *LPOVERLAPPED;
CreateEvent 数据结构:
HANDLE CreateEvent(
PSECURITY_ATTRIBUTES psa,
BOOL bManualReset,
BOOL bInitialState,
PCTSTR pszName);
第一个参数:是安全描述符,设为NULL表示使用默认的安全描述符,并且子进程无法继承返回的句柄。
第二个参数:指定了该内核对象是人工重置(传递TRUE)的还是自动重置(传递FALSE)的。
第三个参数:指定了该内核对象起始状态是已通知(传递TRUE)还是未通知状态(FALSE)。
第四个参数:为要创建的事件内核对象起一个名字,如果传递NULL,则创建一个“匿名”的事件内核对象。如果不传递NULL,且系统中已经存在该名字的事件内核对象,则不创建新的事件内核对象而是打开这个已经存在的,返回它的句柄。
该函数如果成功,返回事件内核对象的句柄,这样就可以操纵它了。如果失败,返回NULL。
事件内核对象(hEvent):
事件内核对象最通常的用途是:让一个线程执行初始化工作,然后触发另一个线程,让它执行剩余的工作,一开始的时候我们将事件初始化为未触发状态,然后当线程完成初始化工作的时候触发事件。
一个事件内核对象的触发表示一个操作已经完成。有两种类型的事件内核对象:手动重置事件和自动重置事件。
当一个手动重置对象被触发的时候,正在等待该事件的所有线程都将变成可调度状态。而当一个自动重置事件被触发时,只有一个正在等待该事件的线程会变成可调度状态。
对同一个文件handle,系统有多个异步操作时(一边读文件头,一边写文件尾, 有一个完成,就会有信号,不能区分是那种操作。),为每个进行中的overlapped调用GetOverlappedResult是不好的作法。
SetEvent设置事件为触发状态,ResetEvent设置事件为未触发状态。
句柄一定要关闭,通过CloseHandle。
C++ 中_In_ 和_out_
__ In__ 表明定义的变量或参数是作为输入,即需要给这个参数赋值,传递给某个函数去执行;
__ out__ 表明定义的变量或参数是作为输出,即需要给该参数一个地址,函数内部往这个地址写数据;
//////////////////////////////////////////////////////////////////
// Setting of chip configuration ( enables/disables streaming mode )
//////////////////////////////////////////////////////////////////
BOOL StartStreamPipe(
// _In_ : it's macro definition, need assign a value to parameter
{
}
https://www.cnblogs.com/leon19870907/archive/2011/09/23/2186291.html
https://www.jianshu.com/p/3afc1eb5bd32