Fonction PostQueuedCompletionStatus (ioapiset.h)

  • Article

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

Voir aussi

CreateIoCompletionPort

Fonctions de gestion des fichiers

GetQueuedCompletionStatus

OVERLAPPED