Fungsi PostQueuedCompletionStatus

Artikel
06/13/2023

Memposting paket penyelesaian I/O ke port penyelesaian I/O.

Sintaks

BOOL WINAPI PostQueuedCompletionStatus(
  _In_     HANDLE       CompletionPort,
  _In_     DWORD        dwNumberOfBytesTransferred,
  _In_     ULONG_PTR    dwCompletionKey,
  _In_opt_ LPOVERLAPPED lpOverlapped
);

Parameter

CompletionPort [in]: Handel ke port penyelesaian I/O tempat paket penyelesaian I/O akan diposting.
dwNumberOfBytesTransferred [in]: Nilai yang akan dikembalikan melalui parameter lpNumberOfBytesTransferred dari fungsi GetQueuedCompletionStatus .
dwCompletionKey [in]: Nilai yang akan dikembalikan melalui parameter lpCompletionKey dari fungsi GetQueuedCompletionStatus .
lpOverlapped [in, opsional]: Nilai yang akan dikembalikan melalui parameter lpOverlapped dari fungsi GetQueuedCompletionStatus .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError .

Keterangan

Paket penyelesaian I/O akan memenuhi panggilan yang luar biasa ke fungsi GetQueuedCompletionStatus . Fungsi ini mengembalikan dengan tiga nilai yang diteruskan sebagai parameter kedua, ketiga, dan keempat dari panggilan ke PostQueuedCompletionStatus. Sistem tidak menggunakan atau memvalidasi nilai-nilai ini. Secara khusus, parameter lpOverlapped tidak perlu menunjuk ke struktur yang TUMPANG TINDIH .

Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Ya
SMB 3.0 Transparent Failover (TFO)	Ya
SMB 3.0 dengan Scale-out File Shares (SO)	Ya
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

CsvF akan melakukan IO yang dialihkan untuk file terkompresi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Header	IoAPI.h (termasuk Windows.h); WinBase.h pada Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

CreateIoCompletionPort
Fungsi Manajemen File
GetQueuedCompletionStatus
TUMPANG TINDIH

Bagikan melalui