LPFN_RIOCLOSECOMPLETIONQUEUE función de devolución de llamada (mswsock.h)

La función RIOCloseCompletionQueue cierra una cola de finalización existente usada para la notificación de finalización de E/S mediante envío y recepción de solicitudes con las extensiones de E/S registradas de Winsock.

Sintaxis

LPFN_RIOCLOSECOMPLETIONQUEUE LpfnRioclosecompletionqueue;

void LpfnRioclosecompletionqueue(
  RIO_CQ CQ
)
{...}

Parámetros

CQ

Descriptor que identifica una cola de finalización existente.

Valor devuelto

None

Observaciones

La función RIOCloseCompletionQueue cierra una cola de finalización existente usada para la finalización de E/S. El kernel bloquea el RIO_CQ pasado en el parámetro CQ para escribirlo. La cola de finalización se marca como no válida, por lo que no se pueden agregar nuevas finalizaciones. Las nuevas finalizaciones que se van a agregar se quitan silenciosamente. Se espera que la aplicación realice un seguimiento de las operaciones de envío o recepción pendientes.

Si se pasa una cola de finalización no válida en el parámetro CQ (RIO_INVALID_CQ, por ejemplo), la función RIOCloseCompletionQueue omite esto.

Nota

El puntero de función a la función RIOCloseCompletionQueue debe obtenerse en tiempo de ejecución realizando una llamada a la función WSAIoctl con el código de operación SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER especificado. El búfer de entrada pasado a la función WSAIoctl debe contener WSAID_MULTIPLE_RIO, un identificador único global (GUID) cuyo valor identifica las funciones de extensión de E/S registradas de Winsock. Si se ejecuta correctamente, la salida devuela por la función WSAIoctl contiene un puntero a la estructura de RIO_EXTENSION_FUNCTION_TABLE que contiene punteros a las funciones de extensión de E/S registradas de Winsock. El SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL se define en el archivo de encabezado Ws2def.h . El GUID de WSAID_MULTIPLE_RIO se define en el archivo de encabezado Mswsock.h .

 

Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Requisito Valor
Header mswsock.h