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

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1
Servidor mínimo com suporte	Windows Server 2012 R2
Plataforma de Destino	Universal
Cabeçalho	winusb.h (inclua Winusb.h)
Biblioteca	Winusb.lib
DLL	Winusb.dll

Confira também

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

Funções do WinUSB

WinUsb_UnregisterIsochBuffer