StartThreadpoolIo-Funktion (threadpoolapiset.h)

Artikel
03/04/2024

Benachrichtigt den Threadpool, dass E/A-Vorgänge möglicherweise für das angegebene E/A-Vervollständigungsobjekt beginnen können. Ein Workerthread ruft die Rückruffunktion des E/A-Vervollständigungsobjekts auf, nachdem der Vorgang für das an dieses Objekt gebundene Dateihandle abgeschlossen wurde.

Syntax

void StartThreadpoolIo(
  [in, out] PTP_IO pio
);

Parameter

[in, out] pio

Ein Zeiger auf eine TP_IO-Struktur , die das E/A-Vervollständigungsobjekt definiert. Die CreateThreadpoolIo-Funktion gibt diesen Zeiger zurück.

Rückgabewert

Keine

Bemerkungen

Sie müssen diese Funktion aufrufen, bevor Sie jeden asynchronen E/A-Vorgang für das Dateihandle initiieren, das an das E/A-Vervollständigungsobjekt gebunden ist. Andernfalls ignoriert der Threadpool einen E/A-Vorgang, wenn er abgeschlossen ist, und führt zu Speicherbeschädigungen.

Wenn der E/A-Vorgang fehlschlägt, rufen Sie die CancelThreadpoolIo-Funktion auf, um diese Benachrichtigung abzubrechen.

Wenn das an das E/A-Vervollständigungsobjekt gebundene Dateihandle über den Benachrichtigungsmodus FILE_SKIP_COMPLETION_PORT_ON_SUCCESS verfügt und ein asynchroner E/A-Vorgang sofort erfolgreich zurückgegeben wird, wird die E/A-Rückruffunktion des Objekts nicht aufgerufen, und threadpool-E/A-Benachrichtigungen müssen abgebrochen werden. Weitere Informationen finden Sie unter CancelThreadpoolIo.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	threadpoolapiset.h (Einschließen von Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

WaitForThreadpoolIoCallbacks