structure SPB_TRANSFER_DESCRIPTOR (spbcx.h)

La structure SPB_TRANSFER_DESCRIPTOR décrit un transfert unique dans une séquence de transfert d’E/S.

Syntaxe

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

Membres

Size

Taille, en octets, de l’ensemble de la structure. Utilisé pour le contrôle de version.

Direction

Direction du transfert. Ce membre est défini sur l’une des valeurs d’énumération SPB_TRANSFER_DIRECTION suivantes :

• SpbTransferDirectionFromDevice
• SpbTransferDirectionToDevice

TransferLength

Nombre d’octets de données à transférer.

DelayInUs

Délai facultatif, en microsecondes, avant le début de ce transfert. Pour plus d'informations, consultez la section Notes qui suit.

Remarques

Cette structure est utilisée par la méthode SpbRequestGetTransferParameters . Avant de passer une structure SPB_TRANSFER_DESCRIPTOR à cette méthode, initialisez la structure en appelant la fonction SPB_TRANSFER_DESCRIPTOR_INIT .

Le membre DelayInUs spécifie un délai avant le début du transfert. Dans certains cas, un pilote de périphérique peut avoir besoin d’insérer un délai entre deux transferts consécutifs dans une séquence. Par exemple, si une écriture sur un appareil cible spécifie le type d’informations demandées, cet appareil peut avoir besoin de temps pour traiter la demande avant que les informations puissent être lues. En outre, un pilote de périphérique peut avoir besoin de spécifier un délai avant le premier transfert dans une séquence. Dans ce cas, le contrôleur doit appliquer l’adresse ou affirmer la ligne de sélection de l’appareil à l’appareil cible pendant l’intervalle de retard spécifié avant le début du premier transfert.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge à partir de Windows 8.
En-tête	spbcx.h

Voir aussi

SPB_TRANSFER_DESCRIPTOR_INIT

SPB_TRANSFER_DIRECTION

SpbRequestGetTransferParameters