GetQueuedCompletionStatus的返回值

GetQueuedCompletionStatus的返回值
2009-06-24 18:52

BOOL WINAPI GetQueuedCompletionStatus(
__in   HANDLE CompletionPort,
__out LPDWORD lpNumberOfBytes,
__out PULONG_PTR lpCompletionKey,
__out LPOVERLAPPED *lpOverlapped,
__in   DWORD dwMilliseconds
);

Return Value

1、非0值:

I/O操作成功,并且从完成端口队列中获取到一个完成包。

I/O的信息被保存到lpNumberOfBytes, lpCompletionKey, and lpOverlapped这几个参数中。

2、0

分两种情况:

*lpOverlapped ==NULL

I/O操作失败,并且没有得到完成包,也没有获得额外的信息。如果想要知道详细信息,需要调用GetLastError函数。其中,等待时间太久会导致WAIT_TIMEOUT错误,是这种情况。

*lpOverlapped != NULL

I/O操作失败,得到了完成包,相应的单端口数据和单I/O数据已经保存,可以用来识别是哪个I/O操作出错。大部分的错误操作是这种情况。

 

=============================================================

 

GetQueuedCompletionStatus的返回值(本人翻译自msdn) 收藏

<script type="text/javascript"></script> <script type="text/javascript"></script>

Return Values

If the function dequeues a completion packet for a successful I/O operation from the completion port, the return value is nonzero. The function stores information in the variables pointed to by the lpNumberOfBytesTransferred , lpCompletionKey , and lpOverlapped parameters.  
 
如果函数从完成端口出列一个成功 I/O 操作的完成包,返回值为非 0 。函数在指向 lpNumberOfBytesTransferred, lpCompletionKey, and lpOverlapped 的参数中存储相关信息。   
 
If * lpOverlapped is NULL and the function does not dequeue a completion packet from the completion port, the return value is zero. The function does not store information in the variables pointed to by the lpNumberOfBytes and lpCompletionKey parameters. To get extended error information, call GetLastError. If the function did not dequeue a completion packet because the wait timed out, GetLastError returns WAIT_TIMEOUT.  
 
如果 *lpOverlapped 为空并且函数没有从完成端口出列完成包,返回值则为 0 。函数则不会在 lpNumberOfBytes and lpCompletionKey 所指向的参数中存储信息。调用 GetLastError 可以得到一个扩展错误信息。如果函数由于等待超时而未能出列完成包, GetLastError 返回 WAIT_TIMEOUT.  
 
If *lpOverlapped is not NULL and the function dequeues a completion packet for a failed I/O operation from the completion port, the return value is zero. The function stores information in the variables pointed to by lpNumberOfBytes, lpCompletionKey, and lpOverlapped. To get extended error information, call GetLastError .  
 
如果 *lpOverlapped 不为空并且函数从完成端口出列一个失败 I/O 操作的完成包,返回值为 0 。函数在指向 lpNumberOfBytesTransferred, lpCompletionKey, and lpOverlapped 的参数指针中存储相关信息。调用 GetLastError 可以得到扩展错误信息  
 
If a socket handle associated with a completion port is closed, GetQueuedCompletionStatus returns ERROR_SUCCESS, with lpNumberOfBytes equal zero.  
 
如果关联到一个完成端口的一个 socket 句柄被关闭了,则 GetQueuedCompletionStatus 返回 ERROR_SUCCESS, 并且 lpNumberOfBytes 等于 0  
 
Remarks( 注意 )
This function associates a thread with the specified completion port. A thread can be associated with at most one completion port.
 
这个函数关联到指定的完成端口的一个线程,一个线程可以关联到最多一个完成端口(一个线程只能为一个完成端口提供服务)
 
The I/O system can be instructed to send completion notification packets to completion ports, where they are queued. The CreateIoCompletionPort function provides a mechanism for this.
 
I/O 系统能够发送完成消息包到完成端口,并使之队列化, CreateIoCompletionPort 函数提供这样的机制
 
When you perform an input/output operation with a file handle that has an associated input/output completion port, the I/O system sends a completion notification packet to the completion port when the I/O operation comple tes. The completion port places the completion packet in a first-in-first-out queue. The GetQueuedCompletionStatus function retrieves these queued completion packets.
 
当在一个与完成端口关联的文件句柄上执行一个输入 / 输出操作, I/O 操作完成的时候, I/O 系统发送一个完成通知包到完成端口。完成端口把这个完成通知包放入到一个先进先出的队列中。 GetQueuedCompletionStatus 函数可以得到这些队列化的完成包
 
A server application may have several threads calling GetQueuedCompletionStatus for the same completion port. As input operations complete, the operating system queues completion packets to the completion port. If threads are actively waiting in a call to this function, queued requests complete their call. For more information, see I/O Completion Ports .
 
一个应用服务可以有多个线程调用 GetQueuedCompletionStatus 为同一个完成端口服务。输入操作完成,操作系统把排好队的完成包交给完成端口。如果线程正在调用这个函数的等待被激发。他们的调用请求也会被排队完成。更多信息请查看 I/O Completion Ports.
 
You can call the PostQueuedCompletionStatus function to post an completion packet to an completion port. The completion packet will satisfy an outstanding call to the GetQueuedCompletionStatus function.
 
你能够调用 PostQueuedCompletionStatus 函数投递一个完成包到一个完成端口,完成包将确保一个可以退出的调用 GetQueuedCompletionStatus 函数
  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
GetQueuedCompletionStatus是Windows操作系统提供的一个函数,用于从完成端口对象中获取已完成的I/O操作。它的原型如下: ```c BOOL GetQueuedCompletionStatus( HANDLE CompletionPort, LPDWORD lpNumberOfBytes, PULONG_PTR lpCompletionKey, LPOVERLAPPED *lpOverlapped, DWORD dwMilliseconds ); ``` 该函数的作用是从指定的完成端口对象中获取已完成的I/O操作,并将相关信息返回给调用者。具体参数的含义如下: - CompletionPort:指定要从中获取完成数据包的完成端口对象。 - lpNumberOfBytes:指向一个变量,用于接收已完成的I/O操作的字节数。 - lpCompletionKey:指向一个变量,用于接收与已完成的I/O操作关联的完成键。 - lpOverlapped:指向一个指针,用于接收与已完成的I/O操作关联的OVERLAPPED结构体的地址。 - dwMilliseconds:指定等待时间,如果没有已完成的I/O操作可用,函数将在此时间内等待。 当调用GetQueuedCompletionStatus函数时,如果有已完成的I/O操作可用,函数将返回TRUE,并将相关信息填充到参数中。如果没有已完成的I/O操作可用,函数将根据dwMilliseconds参数的值决定是否等待,如果等待超时,则函数返回FALSE。 以下是一个示例代码,演示了如何使用GetQueuedCompletionStatus函数: ```c #include <windows.h> int main() { HANDLE completionPort = CreateIoCompletionPort(INVALID_HANDLE_VALUE, NULL, 0, 1); if (completionPort == NULL) { // 创建完成端口失败,处理错误 return 1; } // 向完成端口对象中投递I/O操作 DWORD numberOfBytes; ULONG_PTR completionKey; LPOVERLAPPED overlapped; BOOL result = GetQueuedCompletionStatus(completionPort, &numberOfBytes, &completionKey, &overlapped, INFINITE); if (result) { // 获取已完成的I/O操作成功,处理相关操作 } else { // 获取已完成的I/O操作失败,处理错误 } CloseHandle(completionPort); return 0; } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值