función WinUsb_RegisterIsochBuffer (winusb.h)

La función WinUsb_RegisterIsochBuffer registra un búfer que se va a usar para las transferencias isócrónicas.

Sintaxis

BOOL WinUsb_RegisterIsochBuffer(
  [in]  WINUSB_INTERFACE_HANDLE     InterfaceHandle,
  [in]  UCHAR                       PipeID,
  [in]  PUCHAR                      Buffer,
  [in]  ULONG                       BufferLength,
  [out] PWINUSB_ISOCH_BUFFER_HANDLE IsochBufferHandle
);

Parámetros

[in] InterfaceHandle

Identificador opaco de una interfaz en la configuración seleccionada. Ese identificador debe crearse mediante una llamada anterior a WinUsb_Initialize o WinUsb_GetAssociatedInterface.

[in] PipeID

Derivado del bit 3...0 del campo bEndpointAddress en el descriptor de punto de conexión.

[in] Buffer

Puntero al búfer de transferencia que se va a registrar.

[in] BufferLength

Longitud, en bytes, del búfer de transferencia al que apunta buffer.

[out] IsochBufferHandle

Recibe un identificador opaco para el búfer registrado. Otras funciones de WinUSB requieren este identificador que realizan transferencias isócrónicas. Para liberar el identificador, llame a la función WinUsb_UnregisterIsochBuffer .

Valor devuelto

WinUsb_RegisterIsochBuffer devuelve TRUE si la operación se realiza correctamente. De lo contrario, esta función devuelve FALSE y el autor de la llamada puede recuperar el error registrado llamando a GetLastError.

Si el autor de la llamada establece ContinueStream en TRUE, se produce un error en la transferencia si Winusb.sys no puede programar la transferencia para continuar la secuencia sin quitar uno o varios fotogramas.

Comentarios

Antes de iniciar transferencias isócrónicas a o desde un búfer, el autor de la llamada debe registrar el búfer con WinUsb_RegisterIsochBuffer. Esta llamada permite que el Winusb.sys asigne previamente y bloquee el búfer después de todas las transferencias posteriores mediante el búfer.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1
Servidor mínimo compatible	Windows Server 2012 R2
Plataforma de destino	Universal
Encabezado	winusb.h (incluya Winusb.h)
Library	Winusb.lib
Archivo DLL	Winusb.dll

Consulte también

Envío de transferencias isócrónicas USB desde una aplicación de escritorio winUSB

Funciones winUSB

WinUsb_UnregisterIsochBuffer