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
3 つの構造体の和集合。そのうちの 1 つはバッファーを表します。
u.BufferType
Type メンバーが WdfMemoryDescriptorTypeBuffer の場合、BufferType 構造体のメンバーはバッファーを記述します。 この構造体には、次の 2 つのメンバーが含まれています。
u.BufferType.Buffer
バッファーへのポインター。
u.BufferType.Length
バッファーの長さ (バイト単位)。
u.MdlType
Type メンバーが WdfMemoryDescriptorTypeMdl の場合、MdlType 構造体のメンバーはバッファーを記述します。 この構造体には、次の 2 つのメンバーが含まれています。
u.MdlType.Mdl
メモリ記述子リスト (MDL) へのポインター。
u.MdlType.BufferLength
バッファーの長さ (バイト単位)。
u.HandleType
Type メンバーが WdfMemoryDescriptorTypeHandle の場合、HandleType 構造体のメンバーはバッファーを記述します。 この構造体には、次の 2 つのメンバーが含まれています。
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 |
| Header | wdfmemory.h (Wdf.h を含む) |