função WinUsb_RegisterIsochBuffer (winusb.h)

A função WinUsb_RegisterIsochBuffer registra um buffer a ser usado para transferências isocronas.

Sintaxe

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

Um identificador opaco para uma interface na configuração selecionada. Esse identificador deve ser criado por uma chamada anterior para WinUsb_Initialize ou WinUsb_GetAssociatedInterface.

[in] PipeID

Derivado do Bit 3...0 do campo bEndpointAddress no descritor de ponto de extremidade.

[in] Buffer

Ponteiro para o buffer de transferência a ser registrado.

[in] BufferLength

Comprimento, em bytes, do buffer de transferência apontado por Buffer.

[out] IsochBufferHandle

Recebe um identificador opaco para o buffer registrado. Esse identificador é exigido por outras funções do WinUSB que executam transferências isocronas. Para liberar o identificador, chame a função WinUsb_UnregisterIsochBuffer .

Retornar valor

WinUsb_RegisterIsochBuffer retornará TRUE se a operação for bem-sucedida. Caso contrário, essa função retornará FALSE e o chamador poderá recuperar o erro registrado chamando GetLastError.

Se o chamador definir ContinueStream como TRUE, a transferência falhará se Winusb.sys não puder agendar a transferência para continuar o fluxo sem descartar um ou mais quadros.

Comentários

Antes de iniciar transferências isocronas de ou para um buffer, o chamador deve registrar o buffer com WinUsb_RegisterIsochBuffer. Essa chamada permite que o Winusb.sys pré-mapeie e bloqueie o buffer depois de todas as transferências subsequentes usando o buffer.

Requisitos

Confira também

Enviar transferências isocronas USB de um aplicativo da área de trabalho do WinUSB

Funções do WinUSB

WinUsb_UnregisterIsochBuffer