LPFN_RIOCLOSECOMPLETIONQUEUE funzione di callback (mswsock.h)

La funzione RIOCloseCompletionQueue chiude una coda di completamento esistente usata per la notifica di completamento di I/O tramite l'invio e la ricezione di richieste con le estensioni di I/O registrate winsock.

Sintassi

LPFN_RIOCLOSECOMPLETIONQUEUE LpfnRioclosecompletionqueue;

void LpfnRioclosecompletionqueue(
  RIO_CQ CQ
)
{...}

Parametri

CQ

Descrittore che identifica una coda di completamento esistente.

Valore restituito

nessuno

Osservazioni

La funzione RIOCloseCompletionQueue chiude una coda di completamento esistente usata per il completamento di I/O. Il RIO_CQ passato nel parametro CQ è bloccato per la scrittura dal kernel. La coda di completamento è contrassegnata come non valida, in modo che non sia possibile aggiungere nuovi completamenti. Tutti i nuovi completamenti da aggiungere vengono eliminati automaticamente. L'applicazione deve tenere traccia delle operazioni di invio o ricezione in sospeso.

Se viene passata una coda di completamento non valida nel parametro CQ (ad esempio, RIO_INVALID_CQ), questa operazione viene ignorata dalla funzione RIOCloseCompletionQueue .

Nota

Il puntatore di funzione alla funzione RIOCloseCompletionQueue deve essere ottenuto in fase di esecuzione effettuando una chiamata alla funzione WSAIoctl con il codice operativo SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER specificato. Il buffer di input passato alla funzione WSAIoctl deve contenere WSAID_MULTIPLE_RIO, un identificatore univoco globale (GUID) il cui valore identifica le funzioni di estensione I/O registrate winsock. In caso di esito positivo, l'output restituito dalla funzione WSAIoctl contiene un puntatore alla struttura RIO_EXTENSION_FUNCTION_TABLE che contiene puntatori alle funzioni di estensione di I/O registrate winsock. Il SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL è definito nel file di intestazione Ws2def.h . Il GUID WSAID_MULTIPLE_RIO è definito nel file di intestazione Mswsock.h .

 

Windows Phone 8: questa funzione è supportata per le app dello Store di Windows Phone in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito	Valore
Intestazione	mswsock.h