Fonction PostQueuedCompletionStatus (ioapiset.h)
Poste un paquet d'achèvement d'E/S sur un port d'achèvement d'E/S.
Syntaxe
BOOL PostQueuedCompletionStatus(
[in] HANDLE CompletionPort,
[in] DWORD dwNumberOfBytesTransferred,
[in] ULONG_PTR dwCompletionKey,
[in, optional] LPOVERLAPPED lpOverlapped
);
Paramètres
[in] CompletionPort
Handle vers un port d’achèvement des E/S dans lequel le paquet d’achèvement des E/S doit être publié.
[in] dwNumberOfBytesTransferred
Valeur à retourner via le paramètre lpNumberOfBytesTransferred de la fonction GetQueuedCompletionStatus.
[in] dwCompletionKey
Valeur à retourner via le paramètre lpCompletionKey de la fonction GetQueuedCompletionStatus.
[in, optional] lpOverlapped
Valeur à retourner via le paramètre lpOverlapped de la fonction GetQueuedCompletionStatus.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Le paquet d’achèvement des E/S répondra à un appel en attente à la fonction GetQueuedCompletionStatus. Cette fonction retourne un résultat avec les trois valeurs passées en tant que deuxième, troisième et quatrième paramètres de l’appel à PostQueuedCompletionStatus. Le système n’utilise ni ne valide ces valeurs. En particulier, le paramètre lpOverlapped n’a pas besoin de pointer vers une structure OVERLAPPED.
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Prise en charge |
|---|---|
| Protocole Server Message Block (SMB) 3.0 | Oui |
| Basculement transparent SMB 3.0 (TFO) | Oui |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | Oui |
| Système de fichiers du volume partagé de cluster (CsvFS) | Oui |
| Système de fichiers résilient (ReFS) | Oui |
CsvFs effectue les E/S redirigées pour les fichiers compressés.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | ioapiset.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |