estructura SPB_TRANSFER_LIST (spb.h)
La estructura SPB_TRANSFER_LIST describe una secuencia de transferencia de E/S .
Sintaxis
typedef struct SPB_TRANSFER_LIST {
ULONG Size;
ULONG Reserved;
ULONG TransferCount;
SPB_TRANSFER_LIST_ENTRY Transfers[1];
} SPB_TRANSFER_LIST, *PSPB_TRANSFER_LIST;
Miembros
Size
Tamaño, en bytes, de la estructura SPB_TRANSFER_LIST. Este valor de tamaño no incluye ningún elemento de Transfer matriz que pueda seguir esta estructura. Si se agregan nuevos miembros a versiones futuras de esta estructura, se puede usar el valor Size para determinar qué versión de la estructura de SPB_TRANSFER_LIST se usa.
Reserved
Reservado para su uso por el sistema operativo. Establézcalo en cero.
TransferCount
Número de elementos de la matriz de Transfer. Esta matriz contiene un mínimo de un elemento.
Transfers[1]
Este miembro es el primer elemento de una matriz de estructuras SPB_TRANSFER_LIST_ENTRY. Cada elemento de matriz describe una transferencia individual en la secuencia de transferencia de E/S. Si la matriz contiene más de un elemento, los elementos de matriz adicionales siguen inmediatamente la estructura SPB_TRANSFER_LIST en memoria. Las transferencias se realizan en el orden en que aparecen en la matriz, empezando por el primer elemento.
Observaciones
El búfer de entrada de una solicitud de IOCTL_SPB_EXECUTE_SEQUENCE comienza con una estructura SPB_TRANSFER_LIST. La primera transferencia de la secuencia de transferencia de E/S solicitada se especifica en el transferencias miembro de esta estructura. Si la secuencia contiene más de una transferencia, los elementos de matriz que describen las transferencias adicionales siguen inmediatamente la estructura SPB_TRANSFER_LIST.
El búfer de entrada de una solicitud de IOCTL_SPB_FULL_DUPLEX comienza con una estructura SPB_TRANSFER_LIST. La estructura SPB_TRANSFER_LIST para esta solicitud siempre especifica dos búferes. El primer búfer, que se describe en el transferencias miembro de esta estructura, contiene los datos que se van a escribir en el dispositivo. El segundo búfer, que se describe mediante un elemento de matriz que sigue inmediatamente a la estructura SPB_TRANSFER_LIST, se usa para contener los datos leídos desde el dispositivo.
Si el controlador del controlador SPB admite solicitudes de control de E/S (IOCTL) personalizadas que usan búferes de entrada o salida, use la estructura SPB_TRANSFER_LIST para describir estos búferes. Para obtener más información, vea Using the SPB_TRANSFER_LIST Structure for Custom IOCTLs.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite a partir de Windows 8. |
| encabezado de | spb.h |