LPFN_RIODEREGISTERBUFFER fonction de rappel (mswsock.h)

La fonction RIODeregisterBuffer annule l’inscription d’une mémoire tampon inscrite utilisée avec les extensions d’E/S inscrites winsock.

Syntaxe

LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;

void LpfnRioderegisterbuffer(
  RIO_BUFFERID BufferId
)
{...}

Paramètres

BufferId

Descripteur identifiant une mémoire tampon inscrite.

Valeur de retour

None

Remarques

La fonction RIODeregisterBuffer annule l’inscription d’une mémoire tampon inscrite. Lorsqu’une mémoire tampon est désinscrit, l’application indique qu’elle est effectuée avec l’identificateur de mémoire tampon passé dans le paramètre BufferId . Tous les appels ultérieurs à d’autres fonctions qui tentent d’utiliser cet identificateur de mémoire tampon échoueront.

Si une mémoire tampon toujours en cours d’utilisation est désinscrit, les résultats ne sont pas définis. Cela est considéré comme une erreur grave. Dans la structure RIORESULT retournée par la fonction RIODequeueCompletion, la status est inchangée par rapport à la status normale. Un développeur d’applications peut détecter cette condition d’erreur à l’aide de l’outil Vérificateur d’application.

Si un identificateur de mémoire tampon non valide est passé dans le paramètre BufferId , cela est ignoré par la fonction RIODeregisterBuffer .

Notes

Le pointeur de fonction vers la fonction RIODeregisterBuffer doit être obtenu au moment de l’exécution en effectuant un appel à 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 Windows Phone Store sur 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