Structure WSACOMPLETION (winsock2.h)
La structure WSACOMPLETION spécifie les paramètres de notification d’achèvement pour les appels de contrôle d’E/S effectués à un espace de noms inscrit.
Syntaxe
typedef struct _WSACOMPLETION {
WSACOMPLETIONTYPE Type;
union {
struct {
HWND hWnd;
UINT uMsg;
WPARAM context;
} WindowMessage;
struct {
LPWSAOVERLAPPED lpOverlapped;
} Event;
struct {
LPWSAOVERLAPPED lpOverlapped;
LPWSAOVERLAPPED_COMPLETION_ROUTINE lpfnCompletionProc;
} Apc;
struct {
LPWSAOVERLAPPED lpOverlapped;
HANDLE hPort;
ULONG_PTR Key;
} Port;
} Parameters;
} WSACOMPLETION, *PWSACOMPLETION, *LPWSACOMPLETION;
Membres
Type
Type : WSACOMPLETIONTYPE
Type de notification d’achèvement requis. Consultez la section Notes.
Parameters
Paramètres requis pour terminer le rappel. Les structures au sein de l’union paramètres spécifient les informations requises pour terminer le rappel de chaque type donné. Par exemple, la structure WindowMessage doit être remplie lorsque Type est défini sur NSP_NOTIFY_HWND.
Parameters.WindowMessage
Parameters.WindowMessage.hWnd
Type : HWND Handle Windows.
Parameters.WindowMessage.uMsg
Type : UINT Handle de message.
Parameters.WindowMessage.context
Type : WPARAM Contexte du message ou du handle.
Parameters.Event
Parameters.Event.lpOverlapped
Type : LPWSAOVERLAPPED Pointeur vers une structure WSAOVERLAPPED .
Parameters.Apc
Parameters.Apc.lpOverlapped
Type : LPWSAOVERLAPPED Pointeur vers une structure WSAOVERLAPPED .
Parameters.Apc.lpfnCompletionProc
Type : _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE
Pointeur vers une routine d’achèvement fournie par l’application.
Parameters.Port
Parameters.Port.lpOverlapped
Type : LPWSAOVERLAPPED Pointeur vers une structure WSAOVERLAPPED .
Parameters.Port.hPort
Type : HANDLE Handle du port.
Parameters.Port.Key
Type : ULONG_PTR Pointeur vers la clé.
Remarques
La structure WSACOMPLETION permet de fournir des rappels dans l’un des formats suivants, en fonction de la valeur fournie dans Type :
| Format du rappel | Valeur de type |
|---|---|
| Interrogation | NSP_NOTIFY_IMMEDIATELY |
| Message de fenêtre | NSP_NOTIFY_HWND |
| Événement | NSP_NOTIFY_EVENT |
| APC | NSP_NOTIFY_APC |
| Port d’achèvement | NSP_NOTIFY_PORT |
Pour une fonction bloquante, définissez la structure WSACOMPLETION sur null.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| En-tête | winsock2.h |