WDF_MEMORY_DESCRIPTOR結構 （wdfmemory.h）

[適用於 KMDF 和 UMDF]

WDF_MEMORY_DESCRIPTOR 結構描述記憶體緩衝區。

語法

typedef struct _WDF_MEMORY_DESCRIPTOR {
  WDF_MEMORY_DESCRIPTOR_TYPE Type;
  union {
    struct {
      PVOID Buffer;
      ULONG Length;
    } BufferType;
    struct {
      PMDL  Mdl;
      ULONG BufferLength;
    } MdlType;
    struct {
      WDFMEMORY         Memory;
      PWDFMEMORY_OFFSET Offsets;
    } HandleType;
  } u;
} WDF_MEMORY_DESCRIPTOR, *PWDF_MEMORY_DESCRIPTOR;

成員

Type

WDF_MEMORY_DESCRIPTOR_TYPE型別值，識別這個 WDF_MEMORY_DESCRIPTOR 結構所包含的緩衝區描述類型。

u

三個結構的聯集，其中一個結構描述緩衝區。

u.BufferType

如果 Type 成員是 WdfMemoryDescriptorTypeBuffer，則 BufferType 結構的成員會描述緩衝區。 此結構包含下列兩個成員：

u.BufferType.Buffer

緩衝區的指標。

u.BufferType.Length

緩衝區的長度，以位元組為單位。

u.MdlType

如果 Type 成員是 WdfMemoryDescriptorTypeMdl，則 MdlType 結構的成員會描述緩衝區。 此結構包含下列兩個成員：

u.MdlType.Mdl

記憶體描述元清單的指標（MDL）。

u.MdlType.BufferLength

緩衝區的長度，以位元組為單位。

u.HandleType

如果 Type 成員 WdfMemoryDescriptorTypeHandle，則 HandleType 結構的成員會描述緩衝區。 此結構包含下列兩個成員：

u.HandleType.Memory

架構記憶體物件的句柄。

u.HandleType.Offsets

WDFMEMORY_OFFSET 結構的指標，描述記憶體物件所表示之緩衝區的子區段。

備註

WDF_MEMORY_DESCRIPTOR 結構會作為數個架構 I/O 目標物件方法的輸入， 和 USB 裝置物件方法。

若要初始化 WDF_MEMORY_DESCRIPTOR 結構，您的驅動程式應該呼叫 WDF_MEMORY_DESCRIPTOR_INIT_BUFFER、 或 WDF_MEMORY_DESCRIPTOR_INIT_MDL或 WDF_MEMORY_DESCRIPTOR_INIT_HANDLE。

需求

要求	價值
最低 KMDF 版本	1.0
最低 UMDF 版本	2.0
標題	wdfmemory.h （包括 Wdf.h）

另請參閱

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE