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結構包含之緩衝區描述類型的WDF_MEMORY_DESCRIPTOR_TYPE型別值。

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