estrutura SPB_TRANSFER_DESCRIPTOR (spbcx.h)

A estrutura SPB_TRANSFER_DESCRIPTOR descreve uma única transferência em uma sequência de transferência de E/S.

Sintaxe

typedef struct SPB_TRANSFER_DESCRIPTOR {
  USHORT                 Size;
  SPB_TRANSFER_DIRECTION Direction;
  size_t                 TransferLength;
  ULONG                  DelayInUs;
} SPB_TRANSFER_DESCRIPTOR, *PSPB_TRANSFER_DESCRIPTOR;

Membros

Size

O tamanho, em bytes, de toda a estrutura. Usado para controle de versão.

Direction

A direção da transferência. Esse membro é definido como um dos seguintes valores de enumeração SPB_TRANSFER_DIRECTION :

• SpbTransferDirectionFromDevice
• SpbTransferDirectionToDevice

TransferLength

O número de bytes de dados a serem transferidos.

DelayInUs

Um atraso opcional, em microssegundos, antes que essa transferência comece. Para obter mais informações, consulte a seção Comentários a seguir.

Comentários

Essa estrutura é usada pelo método SpbRequestGetTransferParameters . Antes de passar uma estrutura SPB_TRANSFER_DESCRIPTOR para esse método, inicialize a estrutura chamando a função SPB_TRANSFER_DESCRIPTOR_INIT .

O membro DelayInUs especifica um atraso antes do início da transferência. Em determinados casos, um driver periférico pode precisar inserir um atraso entre duas transferências consecutivas em uma sequência. Por exemplo, se uma gravação em um dispositivo de destino especificar o tipo de informação que está sendo solicitada, esse dispositivo poderá precisar de tempo para processar a solicitação antes que as informações possam ser lidas. Além disso, um driver periférico pode precisar especificar um atraso antes da primeira transferência em uma sequência. Nesse caso, o controlador deve aplicar o endereço ou declarar a linha de seleção do dispositivo ao dispositivo de destino para o intervalo de atraso especificado antes do início da primeira transferência.

Requisitos

Confira também

SPB_TRANSFER_DESCRIPTOR_INIT

SPB_TRANSFER_DIRECTION

SpbRequestGetTransferParameters