Compartir a través de


estructura de SPB_TRANSFER_BUFFER (spb.h)

La estructura de SPB_TRANSFER_BUFFER describe el búfer de datos de una transferencia individual en una secuencia de transferencia de E/S.

Sintaxis

typedef struct SPB_TRANSFER_BUFFER {
  SPB_TRANSFER_BUFFER_FORMAT Format;
  union {
    SPB_TRANSFER_BUFFER_LIST_ENTRY Simple;
    struct {
      PSPB_TRANSFER_BUFFER_LIST_ENTRY List;
      ULONG                           ListCe;
    } BufferList;
    PMDL                           Mdl;
  };
} SPB_TRANSFER_BUFFER, *PSPB_TRANSFER_BUFFER;

Miembros

Format

Formato de búfer. Este miembro se establece en uno de los siguientes valores de enumeración SPB_TRANSFER_BUFFER_FORMAT:

  • SpbTransferBufferFormatSimple
  • SpbTransferBufferFormatList
  • SpbTransferBufferFormatSimpleNonPaged
  • SpbTransferBufferFormatMdl

SpbTransferBufferFormatMdl es un valor válido solo para las secuencias de transferencia de E/S solicitadas por los clientes del controlador spb que son componentes en modo kernel.

Simple

Estructura SPB_TRANSFER_BUFFER_LIST_ENTRY que especifica la dirección base y la longitud de un búfer de transferencia simple. Use este miembro de la unión si Format es SpbTransferBufferFormatSimple o SpbTransferBufferFormatSimpleNonPaged. Los clientes en modo kernel usan el formato SpbTransferBufferFormatSimpleNonPaged .

BufferList

Lista de recopilación de dispersión que consta de una matriz de descriptores de búfer. Use este miembro de la unión si Format es SpbTransferBufferFormatList.

BufferList.List

Puntero a una matriz de estructuras de SPB_TRANSFER_BUFFER_LIST_ENTRY que describen los búferes de la lista de recopilación de dispersión.

BufferList.ListCe

Número de elementos de la matriz List .

Mdl

Puntero a una MDL que describe el búfer. Este miembro solo lo usan los clientes en modo kernel. Use este miembro de la unión si Format es SpbTransferBufferFormatMdl. Para obtener más información, vea la sección Comentarios.

Comentarios

Esta estructura la usa una estructura de SPB_TRANSFER_LIST_ENTRY para describir un búfer de transferencia.

El miembro Mdl de esta estructura solo puede ser utilizado por los clientes del controlador SPB que son componentes en modo kernel. Los clientes en modo de usuario no deben usar este miembro. Para obtener más información sobre las MDL, consulte Uso de MDL.

Requisitos

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

Consulte también