PostQueuedCompletionStatus-Funktion (ioapiset.h)

  • Artikel

Sendet ein E/A-Abschlusspaket an einen E/A-Abschlussport

Syntax

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

Parameter

[in] CompletionPort

Ein Handle an einen E/A-Abschlussport, an den das E/A-Abschlusspaket gesendet werden soll

[in] dwNumberOfBytesTransferred

Der Wert, der mit dem Parameter lpNumberOfBytesTransferred der Funktion GetQueuedCompletionStatus zurückgegeben werden soll

[in] dwCompletionKey

Der Wert, der mit dem Parameter lpCompletionKey der Funktion GetQueuedCompletionStatus zurückgegeben werden soll

[in, optional] lpOverlapped

Der Wert, der mit dem Parameter lpOverlapped der Funktion GetQueuedCompletionStatus zurückgegeben werden soll

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Das E/A-Vervollständigungspaket erfüllt einen ausstehenden Aufruf der Funktion GetQueuedCompletionStatus. Diese Funktion wird mit den drei Werten zurückgegeben, die als zweiter, dritter und vierter Parameter des Aufrufs von PostQueuedCompletionStatus übergeben werden. Das System verwendet oder überprüft diese Werte nicht. Insbesondere muss der Parameter lpOverlapped nicht auf eine OVERLAPPED-Struktur verweisen.

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie Unterstützt
SMB 3.0-Protokoll (Server Message Block) Ja
SMB 3.0 Transparent Failover (TFO) Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS) Ja
Robustes Dateisystem (Resilient File System, ReFS) Ja
 

CsvFs leiten E/A für komprimierte Dateien um.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile ioapiset.h (Einschließen von Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

CreateIoCompletionPort

Dateiverwaltungsfunktionen

GetQueuedCompletionStatus

OVERLAPPED