spb.h) (的 SPB_TRANSFER_BUFFER 結構

  • 發行項

SPB_TRANSFER_BUFFER 結構描述 I/O 傳輸順序中個別傳輸的數據緩衝區。

語法

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;

成員

Format

緩衝區格式。 這個成員會設定為下列其中一個 SPB_TRANSFER_BUFFER_FORMAT 列舉值：

  • SpbTransferBufferFormatSimple
  • SpbTransferBufferFormatList
  • SpbTransferBufferFormatSimpleNonPaged
  • SpbTransferBufferFormatMdl

SpbTransferBufferFormatMdl 僅適用於SPB控制器驅動程式用戶端要求且為核心模式元件的 I/O 傳輸序列的有效值。

Simple

SPB_TRANSFER_BUFFER_LIST_ENTRY 結構，指定簡單傳輸緩衝區的基地址和長度。 如果 Format 為 SpbTransferBufferFormatSimple 或 SpbTransferBufferFormatSimpleNonPaged，請使用這個等位的成員。 SpbTransferBufferFormatSimpleNonPaged 格式僅供核心模式用戶端使用。

BufferList

由緩衝區描述元陣列組成的散佈收集清單。 如果 Format 是 SpbTransferBufferFormatList，請使用聯集的這個成員。

BufferList.List

描述散佈收集清單中緩衝區 之SPB_TRANSFER_BUFFER_LIST_ENTRY 結構的陣列指標。

BufferList.ListCe

List 陣列中的項目數目。

Mdl

描述緩衝區之 MDL 的指標。 此成員僅供核心模式用戶端使用。 如果 Format 為 SpbTransferBufferFormatMdl，請使用聯集的這個成員。 如需詳細資訊，請參閱＜備註＞。

備註

此結構是由 SPB_TRANSFER_LIST_ENTRY 結構用來描述傳輸緩衝區。

這個結構的 Mdl 成員只能由屬於核心模式元件的 SPB 控制器驅動程式用戶端使用。 使用者模式用戶端不得使用此成員。 如需 MDL 的詳細資訊，請參閱 使用 MDL。

規格需求

需求 值
最低支援的用戶端 從 Windows 8 開始支援。
標頭 spb.h

另請參閱