estructura de SPB_TRANSFER_DESCRIPTOR (spbcx.h)

La estructura de SPB_TRANSFER_DESCRIPTOR describe una sola transferencia en una secuencia de transferencia de E/S.

Sintaxis

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

Miembros

Size

Tamaño, en bytes, de toda la estructura. Se usa para el control de versiones.

Direction

Dirección de la transferencia. Este miembro se establece en uno de los siguientes valores de enumeración SPB_TRANSFER_DIRECTION :

  • SpbTransferDirectionFromDevice
  • SpbTransferDirectionToDevice

TransferLength

Número de bytes de datos que se van a transferir.

DelayInUs

Un retraso opcional, en microsegundos, antes de que comience esta transferencia. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Comentarios

El método SpbRequestGetTransferParameters usa esta estructura. Antes de pasar una estructura de SPB_TRANSFER_DESCRIPTOR a este método, inicialice la estructura llamando a la función SPB_TRANSFER_DESCRIPTOR_INIT .

El miembro DelayInUs especifica un retraso antes del inicio de la transferencia. En ciertos casos, un controlador periférico podría necesitar insertar un retraso entre dos transferencias consecutivas en una secuencia. Por ejemplo, si una escritura en un dispositivo de destino especifica el tipo de información que se solicita, es posible que este dispositivo necesite tiempo para procesar la solicitud antes de que se pueda leer la información. Además, un controlador periférico podría necesitar especificar un retraso antes de la primera transferencia en una secuencia. En este caso, el controlador debe aplicar la dirección o declarar la línea de selección de dispositivo al dispositivo de destino para el intervalo de retraso especificado antes del inicio de la primera transferencia.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 8.
Encabezado spbcx.h

Consulte también

SPB_TRANSFER_DESCRIPTOR_INIT

SPB_TRANSFER_DIRECTION

SpbRequestGetTransferParameters