LPFN_RIODEREGISTERBUFFER funzione di callback (mswsock.h)

La funzione RIODeregisterBuffer deregisters un buffer registrato usato con le estensioni di I/O registrate winsock.

Sintassi

LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;

void LpfnRioderegisterbuffer(
  RIO_BUFFERID BufferId
)
{...}

Parametri

BufferId

Descrittore che identifica un buffer registrato.

Valore restituito

nessuno

Osservazioni

La funzione RIODeregisterBuffer deregisters un buffer registrato. Quando un buffer viene deregisterato, l'applicazione indica che viene eseguita con l'identificatore del buffer passato nel parametro BufferId . Tutte le chiamate successive ad altre funzioni che tentano di usare questo identificatore di buffer avranno esito negativo.

Se un buffer ancora in uso viene deregiregistrato, i risultati non vengono definiti. Questo è considerato un errore grave. Nella struttura RIORESULT restituita dalla funzione RIODequeueCompletion lo stato verrà invariato dallo stato normale. Uno sviluppatore di applicazioni può rilevare questa condizione di errore usando lo strumento Verifica applicazione.

Se un identificatore di buffer non valido viene passato nel parametro BufferId , questo viene ignorato dalla funzione RIODeregisterBuffer .

Nota

Il puntatore alla funzione RIODeregisterBuffer deve essere ottenuto in fase di esecuzione eseguendo una chiamata alla funzione WSAIoctl con il codice opcode 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 Windows Phone Store 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