estructura de SPB_TRANSFER_LIST (spb.h)
La estructura de 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 matriz Transfer 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. Establecer en cero.
TransferCount
Número de elementos de la matriz Transfers . Esta matriz contiene un mínimo de un elemento.
Transfers[1]
Este miembro es el primer elemento de una matriz de estructuras de 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.
Comentarios
El búfer de entrada de una solicitud de IOCTL_SPB_EXECUTE_SEQUENCE comienza con una estructura de SPB_TRANSFER_LIST . La primera transferencia de la secuencia de transferencia de E/S solicitada se especifica en el miembro Transfer 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 de SPB_TRANSFER_LIST . La estructura SPB_TRANSFER_LIST para esta solicitud siempre especifica dos búferes. El primer búfer, que se describe mediante el miembro Transfer 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 de SPB_TRANSFER_LIST , se usa para contener los datos leídos desde el dispositivo.
Si el 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, consulte Uso de la estructura de SPB_TRANSFER_LIST para ICTLs personalizados.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 8. |
| Encabezado | spb.h |