função WinUsb_ReadIsochPipe (winusb.h)

A função WinUsb_ReadIsochPipe lê dados de um ponto de extremidade IN isócrono.

Sintaxe

BOOL WinUsb_ReadIsochPipe(
  [in]           WINUSB_ISOCH_BUFFER_HANDLE  BufferHandle,
  [in]           ULONG                       Offset,
  [in]           ULONG                       Length,
  [in, out]      PULONG                      FrameNumber,
  [in]           ULONG                       NumberOfPackets,
  [out]          PUSBD_ISO_PACKET_DESCRIPTOR IsoPacketDescriptors,
  [in, optional] LPOVERLAPPED                Overlapped
);

Parâmetros

[in] BufferHandle

Um identificador opaco para o buffer de transferência que foi registrado por uma chamada anterior para WinUsb_RegisterIsochBuffer.

[in] Offset

Deslocamento para o buffer em relação ao início da transferência.

[in] Length

Comprimento em bytes do buffer de transferência.

[in, out] FrameNumber

Na entrada, indica o número do quadro inicial para a transferência. Na saída, contém o número do quadro que segue o último quadro usado na transferência.

[in] NumberOfPackets

Número total de pacotes isócronos necessários para manter o buffer de transferência. Também indica o número de elementos na matriz apontada por IsoPacketDescriptors.

[out] IsoPacketDescriptors

Uma matriz de estruturas de USBD_ISO_PACKET_DESCRIPTOR . Após a conclusão da transferência, cada elemento contém o status e o tamanho do pacote isocrono.

[in, optional] Overlapped

Ponteiro para uma estrutura OVERLAPPED usada para operações assíncronas.

Retornar valor

WinUsb_ReadIsochPipe 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.

Comentários

WinUsb_ReadIsochPipe em pacotes o buffer de transferência para que, em cada intervalo de 1ms, o host possa receber o máximo de bytes permitidos por intervalo. Os bytes máximos são especificados pelo descritor de ponto de extremidade para pontos de extremidade completos e de alta velocidade e o descritor complementar de ponto de extremidade para pontos de extremidade SuperSpeed. Se o chamador enviar várias solicitações de leitura para transmitir dados do dispositivo, o tamanho da transferência deverá ser um múltiplo dos bytes máximos por intervalo (conforme retornado por WinUsb_QueryPipeEx) * 8 /interval.

Devido ao empacotamento de transferência usado na interface subjacente do modo kernel, a notificação de latência mais baixa para um aplicativo ou driver é de intervalos de 1ms.

Requisitos

Confira também

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

Funções do WinUSB