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

La función RIODeregisterBuffer registra un búfer registrado usado con las extensiones de E/S registradas de Winsock.

Sintaxis

LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;

void LpfnRioderegisterbuffer(
  RIO_BUFFERID BufferId
)
{...}

Parámetros

BufferId

Descriptor que identifica un búfer registrado.

Valor devuelto

None

Observaciones

La función RIODeregisterBuffer anula el registro de un búfer registrado. Cuando se anula el registro de un búfer, la aplicación indica que se realiza con el identificador de búfer pasado en el parámetro BufferId . Se producirá un error en las llamadas posteriores a otras funciones que intenten usar este identificador de búfer.

Si se anula el registro de un búfer que todavía está en uso, los resultados no están definidos. Esto se considera un error grave. En la estructura RIORESULT devuelta por la función RIODequeueCompletion , el estado no cambiará del estado normal. Un desarrollador de aplicaciones puede detectar esta condición de error mediante la herramienta Comprobador de aplicaciones.

Si se pasa un identificador de búfer no válido en el parámetro BufferId , la función RIODeregisterBuffer lo omite.

Nota

El puntero de función a la función RIODeregisterBuffer se debe obtener 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