GetQueuedCompletionStatusEx 함수(ioapiset.h)
여러 완료 포트 항목을 동시에 검색합니다. 지정된 완료 포트와 연결된 보류 중인 I/O 작업이 완료될 때까지 기다립니다.
I/O 완료 패킷을 한 번에 하나씩 큐에서 제거하려면 GetQueuedCompletionStatus 함수를 사용합니다.
통사론
BOOL GetQueuedCompletionStatusEx(
[in] HANDLE CompletionPort,
[out] LPOVERLAPPED_ENTRY lpCompletionPortEntries,
[in] ULONG ulCount,
[out] PULONG ulNumEntriesRemoved,
[in] DWORD dwMilliseconds,
[in] BOOL fAlertable
);
매개 변수
[in] CompletionPort
완료 포트에 대한 핸들입니다. 완료 포트를 만들려면 CreateIoCompletionPort 함수를 사용합니다.
[out] lpCompletionPortEntries
입력에서 미리 할당된 OVERLAPPED_ENTRY 구조체 배열을 가리킵니다.
출력 시 항목을 포함하는 OVERLAPPED_ENTRY 구조체의 배열을 받습니다. 배열 요소 수는 ulNumEntriesRemoved
각 I/O 중에 전송된 바이트 수, 각 I/O가 발생한 파일을 나타내는 완성 키 및 각 원본 I/O에 사용된 겹치는 구조체 주소는 모두 lpCompletionPortEntries 배열에 반환됩니다.
[in] ulCount
제거할 최대 항목 수입니다.
[out] ulNumEntriesRemoved
실제로 제거된 항목 수를 받는 변수에 대한 포인터입니다.
[in] dwMilliseconds
완료 패킷이 완료 포트에 나타날 때까지 호출자가 대기하려는 시간(밀리초)입니다. 지정된 시간 내에 완료 패킷이 나타나지 않으면 함수의 시간이 초과되고 FALSE
dwMillisecondsINFINITE(0xFFFFFFFF)인 경우 함수는 시간이 초과되지 않습니다. 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 값에는 저전력 상태에서 소요된 시간이 포함되지 않습니다. 예를 들어 컴퓨터가 절전 모드인 동안 시간 제한은 계속 카운트다운되지 않습니다.
[in] fAlertable
이 매개 변수가 FALSE
매개 변수가 TRUE
ReadFileEx 또는 WriteFileEx 함수가 완료되고 호출 스레드가 작업을 시작한 스레드인 경우 완료 루틴이 큐에 대기됩니다. QueueUserAPC호출하면 APC가 큐에 대기됩니다.
반환 값
성공하면 0이 아닌 값(
확장 오류 정보를 얻으려면 GetLastError호출합니다.
발언
이 함수는 스레드를 지정된 완료 포트와 연결합니다. 스레드는 최대 하나의 완료 포트와 연결할 수 있습니다.
이 함수는 보류 중인 I/O가 하나 이상 완료되면 TRUE
이 함수는 큐에서 해제된 I/O 작업이 없는 경우 FALSE 반환합니다. 이는 일반적으로 이 호출에 대한 매개 변수를 처리하는 동안 오류가 발생했거나 CompletionPort 핸들이 닫혔거나 유효하지 않음을 의미합니다. GetLastError 함수는 확장된 오류 정보를 제공합니다.
연결된 핸들이 닫혀
서버 애플리케이션에는 동일한 완료 포트에 대한 GetQueuedCompletionStatusEx 함수를 호출하는 여러 스레드가 있을 수 있습니다. I/O 작업이 완료되면 선착순으로 이 포트에 큐에 대기합니다. 스레드가 이 호출을 적극적으로 대기 중인 경우 하나 이상의 대기 중인 요청이 해당 스레드에 대한 호출만 완료합니다.
I/O 완성 포트 이론, 사용 및 관련 함수에 대한 자세한 내용은 I/O 완료 포트참조하세요.
Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술에서 지원됩니다.
| 기술 | 지원 |
|---|---|
| SMB(서버 메시지 블록) 3.0 프로토콜 | 예 |
| SMB 3.0 TFO(투명한 장애 조치(failover) | 예 |
| SO(스케일 아웃 파일 공유)가 있는 SMB 3.0 | 예 |
| CsvFS(클러스터 공유 볼륨 파일 시스템) | 예 |
| ReFS(복원 파일 시스템) | 예 |
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | ioapiset.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |
참고 항목
ConnectNamedPipe
CreateIoCompletionPort
DeviceIoControl
함수
GetQueuedCompletionStatusEx
LockFileEx
개요 항목
ReadFile
transactNamedPipe
windows 헤더 사용하는
WriteFile