LPFN_RIOCLOSECOMPLETIONQUEUE fonction de rappel (mswsock.h)

La fonction RIOCloseCompletionQueue ferme une file d’attente d’achèvement existante utilisée pour la notification de fin d’E/S en envoyant et en recevant des demandes avec les extensions d’E/S inscrites dans Winsock.

Syntaxe

LPFN_RIOCLOSECOMPLETIONQUEUE LpfnRioclosecompletionqueue;

void LpfnRioclosecompletionqueue(
  RIO_CQ CQ
)
{...}

Paramètres

CQ

Descripteur identifiant une file d’attente d’achèvement existante.

Valeur de retour

None

Remarques

La fonction RIOCloseCompletionQueue ferme une file d’attente d’achèvement existante utilisée pour la saisie semi-automatique. Le RIO_CQ passé dans le paramètre CQ est verrouillé pour l’écriture par le noyau. La file d’attente d’achèvement est marquée comme non valide, de sorte que de nouvelles saisies ne peuvent pas être ajoutées. Toutes les nouvelles complétions à ajouter sont supprimées en mode silencieux. L’application est censée suivre toutes les opérations d’envoi ou de réception en attente.

Si une file d’attente d’achèvement non valide est passée dans le paramètre CQ (RIO_INVALID_CQ, par exemple), cela est ignoré par la fonction RIOCloseCompletionQueue .

Notes

Le pointeur de fonction vers la fonction RIOCloseCompletionQueue doit être obtenu au moment de l’exécution en appelant la fonction WSAIoctl avec l’opcode SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER spécifié. La mémoire tampon d’entrée passée à la fonction WSAIoctl doit contenir WSAID_MULTIPLE_RIO, un identificateur global unique (GUID) dont la valeur identifie les fonctions d’extension d’E/S inscrites dans Winsock. En cas de réussite, la sortie retournée par la fonction WSAIoctl contient un pointeur vers la structure RIO_EXTENSION_FUNCTION_TABLE qui contient des pointeurs vers les fonctions d’extension d’E/S inscrites dans Winsock. Le SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL est défini dans le fichier d’en-tête Ws2def.h . Le GUID WSAID_MULTIPLE_RIO est défini dans le fichier d’en-tête Mswsock.h .

 

Windows Phone 8 : cette fonction est prise en charge pour les applications du Store Windows Phone Windows Phone 8 et versions ultérieures.

Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

Configuration requise

Condition requise	Valeur
En-tête	mswsock.h