LPWSAOVERLAPPED_COMPLETION_ROUTINE fonction de rappel (winsock2.h)

LPWSAOVERLAPPED_COMPLETION_ROUTINE est un type de pointeur de fonction. Vous implémentez une fonction de rappel correspondante dans votre application et passez-la à des fonctions telles que WSAIoctl, WSARecv et WSASend, entre autres.

Le système appelle votre fonction de rappel lorsque l’opération asynchrone d’entrée et de sortie (E/S) est terminée ou annulée, et que le thread appelant est dans un état alertable (à l’aide de la fonction SleepEx, MsgWaitForMultipleObjectsEx, WaitForSingleObjectEx ou WaitForMultipleObjectsEx avec le paramètre fAlertable défini sur TRUE).

Syntaxe

LPWSAOVERLAPPED_COMPLETION_ROUTINE LpwsaoverlappedCompletionRoutine;

void LpwsaoverlappedCompletionRoutine(
  DWORD dwError,
  DWORD cbTransferred,
  LPWSAOVERLAPPED lpOverlapped,
  DWORD dwFlags
)
{...}

Paramètres

dwError

Type : IN DWORD

Status d’achèvement des E/S. Ce paramètre peut être l’un des codes d’erreur système.

cbTransferred

Type : IN DWORD

Nombre d'octets transférés. Si une erreur se produit, ce paramètre est égal à zéro.

lpOverlapped

Type : IN LPWSAOVERLAPPED

Pointeur vers la structure WSAOVERLAPPED spécifiée par la fonction d’E/S asynchrone.

Le système n’utilise pas la structure WSAOVERLAPPED après l’appel de la routine d’achèvement, de sorte que la routine d’achèvement peut libérer la mémoire utilisée par la structure qui se chevauche.

dwFlags

Type : IN DWORD

Indicateurs associés à l’appel.

Valeur de retour

None

Remarques

Voir LPOVERLAPPED_COMPLETION_ROUTINE.

Configuration requise