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

A função RIOCloseCompletionQueue fecha uma fila de conclusão existente usada para notificação de conclusão de E/S enviando e recebendo solicitações com as extensões de E/S registradas do Winsock.

Sintaxe

LPFN_RIOCLOSECOMPLETIONQUEUE LpfnRioclosecompletionqueue;

void LpfnRioclosecompletionqueue(
  RIO_CQ CQ
)
{...}

Parâmetros

CQ

Um descritor que identifica uma fila de conclusão existente.

Retornar valor

Nenhum

Comentários

A função RIOCloseCompletionQueue fecha uma fila de conclusão existente usada para conclusão de E/S. O RIO_CQ passado no parâmetro CQ está bloqueado para gravação pelo kernel. A fila de conclusão é marcada como inválida, para que novas conclusões não possam ser adicionadas. Quaisquer novas conclusões a serem adicionadas são silenciosamente descartadas. Espera-se que o aplicativo acompanhe todas as operações de envio ou recebimento pendentes.

Se uma fila de conclusão inválida for passada no parâmetro CQ (RIO_INVALID_CQ, por exemplo), isso será ignorado pela função RIOCloseCompletionQueue .

Observação

O ponteiro de função para a função RIOCloseCompletionQueue 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