PostQueuedCompletionStatus 함수(ioapiset.h)

I/O 완료 패킷을 I/O 완료 포트에 게시합니다.

구문

BOOL PostQueuedCompletionStatus(
  [in]           HANDLE       CompletionPort,
  [in]           DWORD        dwNumberOfBytesTransferred,
  [in]           ULONG_PTR    dwCompletionKey,
  [in, optional] LPOVERLAPPED lpOverlapped
);

매개 변수

[in] CompletionPort

I/O 완료 패킷을 게시할 I/O 완료 포트에 대한 핸들입니다.

[in] dwNumberOfBytesTransferred

GetQueuedCompletionStatus 함수의 lpNumberOfBytesTransferred 매개 변수를 통해 반환되는 값입니다.

[in] dwCompletionKey

GetQueuedCompletionStatus 함수의 lpCompletionKey 매개 변수를 통해 반환되는 값입니다.

[in, optional] lpOverlapped

GetQueuedCompletionStatus 함수의 lpOverlapped 매개 변수를 통해 반환되는 값입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

I/O 완료 패킷은 GetQueuedCompletionStatus 함수에 대한 미해결 호출을 충족합니다. 이 함수는 PostQueuedCompletionStatus 호출의 두 번째, 세 번째 및 네 번째 매개 변수로 전달된 세 개의 값을 반환합니다. 시스템은 이러한 값을 사용하거나 유효성을 검사하지 않습니다. 특히 lpOverlapped 매개 변수는 OVERLAPPED 구조를 가리킬 필요가 없습니다.

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

기술	지원됨
SMB(서버 메시지 블록) 3.0 프로토콜	Yes
SMB 3.0 TFO(투명 장애 조치(failover))	Yes
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0	Yes
CsvFS(클러스터 공유 볼륨 파일 시스템)	Yes
ReFS(Resilient File System)	예

 

CsvF는 압축된 파일에 대해 리디렉션된 IO를 수행합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	ioapiset.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

CreateIoCompletionPort

파일 관리 함수

GetQueuedCompletionStatus

OVERLAPPED