GetQueuedCompletionStatus 함수(ioapiset.h)

지정된 I/O 완료 포트에서 I/O 완료 패킷을 큐에서 제거하려고 시도합니다. 대기 중인 완료 패킷이 없으면 함수는 완료 포트와 연결된 보류 중인 I/O 작업이 완료될 때까지 기다립니다.

여러 I/O 완료 패킷을 한 번에 큐에서 제거하려면 GetQueuedCompletionStatusEx 함수를 사용합니다.

통사론

BOOL GetQueuedCompletionStatus(
  [in]  HANDLE       CompletionPort,
        LPDWORD      lpNumberOfBytesTransferred,
  [out] PULONG_PTR   lpCompletionKey,
  [out] LPOVERLAPPED *lpOverlapped,
  [in]  DWORD        dwMilliseconds
);

매개 변수

[in] CompletionPort

완료 포트에 대한 핸들입니다. 완료 포트를 만들려면 CreateIoCompletionPort 함수를 사용합니다.

lpNumberOfBytesTransferred

완료된 I/O 작업에서 전송된 바이트 수를 받는 변수에 대한 포인터입니다.

[out] lpCompletionKey

I/O 작업이 완료된 파일 핸들과 연결된 완료 키 값을 받는 변수에 대한 포인터입니다. 완성 키는 createIoCompletionPort호출에 지정된 파일별 키입니다.

[out] lpOverlapped

완료된 I/O 작업이 시작될 때 지정된 OVERLAPPED 구조체의 주소를 수신하는 변수에 대한 포인터입니다.

함수를 완료 포트와 연결된 파일 핸들과 유효한 OVERLAPPED 구조를 전달한 경우에도 애플리케이션은 완료 포트 알림을 방지할 수 있습니다. 이 작업은 OVERLAPPED 구조체의 hEvent 멤버에 대한 유효한 이벤트 핸들을 지정하고 낮은 순서의 비트를 설정하여 수행됩니다. 낮은 순서의 비트가 설정된 유효한 이벤트 핸들은 겹치는 I/O가 완료 패킷을 완료 포트로 큐에 추가하지 못하도록 합니다.

[in] dwMilliseconds

완료 패킷이 완료 포트에 나타날 때까지 호출자가 대기하려는 시간(밀리초)입니다. 지정된 시간 내에 완료 패킷이 나타나지 않으면 함수가 시간 초과되고, FALSE반환하고, *lpOverlapped NULL설정합니다.

dwMilliseconds INFINITE경우 함수는 시간이 초과되지 않습니다. dwMilliseconds 0이고 큐에 넣기 위한 I/O 작업이 없는 경우 함수는 즉시 시간이 초과됩니다.

Windows XP, Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 및 Windows Server 2008 R2:dwMilliseconds 값에는 저전력 상태에서 소요된 시간이 포함됩니다. 예를 들어 컴퓨터가 절전 모드인 동안 시간 제한이 계속 카운트다운됩니다.

Windows 8 이상 Windows Server 2012 이상:dwMilliseconds 값에는 저전력 상태에서 소요된 시간이 포함되지 않습니다. 예를 들어 컴퓨터가 절전 모드인 동안 시간 제한은 계속 카운트다운되지 않습니다.

반환 값

성공하면 0이 아닌 값(TRUE)을 반환하고, 그렇지 않으면 0(false)을 반환합니다.

확장 오류 정보를 얻으려면 GetLastError호출합니다.

자세한 내용은 설명 섹션을 참조하세요.

발언

이 함수는 스레드를 지정된 완료 포트와 연결합니다. 스레드는 최대 하나의 완료 포트와 연결할 수 있습니다.

호출이 처리 중인 동안 연결된 완료 포트 핸들이 닫혀 GetQueuedCompletionStatus에 대한 호출이 실패하면 함수는 FALSE반환합니다. *lpOverlapped NULLGetLastError ERROR_ABANDONED_WAIT_0반환합니다.

Windows Server 2003 및 Windows XP: 호출이 미해결 상태인 동안 완료 포트 핸들을 닫으면 이전에 설명한 동작이 발생하지 않습니다. 함수는 포트에서 항목이 제거될 때까지 또는 제한 시간이 발생할 때까지 계속 대기합니다(INFINITE이외의 값으로 지정된 경우).

GetQueuedCompletionStatus 함수가 성공하면 완료 포트에서 성공적인 I/O 작업에 대한 완료 패킷을 큐에서 제거하고 다음 매개 변수가 가리키는 변수에 정보를 저장했습니다. lpNumberOfBytes, lpCompletionKey및 lpOverlapped. 오류가 발생하면(반환 값이 FALSE) 동일한 매개 변수는 다음과 같이 특정 값 조합을 포함할 수 있습니다.

• *lpOverlapped NULL경우 함수는 완료 포트에서 완료 패킷을 큐에서 제거하지 않았습니다. 이 경우 함수는 lpNumberOfBytes 및 lpCompletionKey 매개 변수가 가리키는 변수에 정보를 저장하지 않으며 해당 값은 확정되지 않습니다.
• *lpOverlapped NULL 않고 함수가 완료 포트에서 실패한 I/O 작업에 대한 완료 패킷을 큐에서 제거하는 경우 이 함수는 lpNumberOfBytes, lpCompletionKey및 lpOverlapped가리키는 변수에 실패한 작업에 대한 정보를 저장합니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술에서 지원됩니다.

요구 사항

참고 항목

ConnectNamedPipe

CreateIoCompletionPort

DeviceIoControl

파일 관리 함수

함수

GetQueuedCompletionStatusEx

I/O 완료 포트

LockFileEx

개요 항목

PostQueuedCompletionStatus

ReadFile

transactNamedPipe

windows 헤더 사용하는

WaitCommEvent

WriteFile