LPFN_RIODEREGISTERBUFFER função de retorno de chamada (mswsock.h)

A função RIODeregisterBuffer desregistra um buffer registrado usado com as extensões de E/S registradas do Winsock.

Sintaxe

LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;

void LpfnRioderegisterbuffer(
  RIO_BUFFERID BufferId
)
{...}

Parâmetros

BufferId

Um descritor que identifica um buffer registrado.

Retornar valor

Nenhum

Comentários

A função RIODeregisterBuffer desregistra um buffer registrado. Quando um buffer é desregistrado, o aplicativo indica que ele é feito com o identificador de buffer passado no parâmetro BufferId . Todas as chamadas subsequentes para outras funções que tentarem usar esse identificador de buffer falharão.

Se um buffer que ainda está em uso for desregistrado, os resultados serão indefinidos. Isso é considerado um erro grave. Na estrutura RIORESULT retornada pela função RIODequeueCompletion, o status será inalterado do status normal. Um desenvolvedor de aplicativos pode detectar essa condição de erro usando a ferramenta Verificador de Aplicativos.

Se um identificador de buffer inválido for passado no parâmetro BufferId , isso será ignorado pela função RIODeregisterBuffer .

Observação

O ponteiro de função para a função RIODeregisterBuffer deve ser obtido em tempo de execução fazendo uma chamada para a função WSAIoctl com o SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER opcode especificado. O buffer de entrada passado para a função WSAIoctl deve conter WSAID_MULTIPLE_RIO, um GUID (identificador global exclusivo) cujo valor identifica as funções de extensão de E/S registradas do Winsock. Em caso de êxito, a saída retornada pela função WSAIoctl contém um ponteiro para a estrutura RIO_EXTENSION_FUNCTION_TABLE que contém ponteiros para as funções de extensão de E/S registradas do Winsock. O SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL é definido no arquivo de cabeçalho Ws2def.h . O GUID WSAID_MULTIPLE_RIO é definido no arquivo de cabeçalho Mswsock.h .

 

Windows Phone 8: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.

Requisitos

Requisito	Valor
Cabeçalho	mswsock.h