WDF_MEMORY_DESCRIPTOR-Struktur (wdfmemory.h)
[Gilt für KMDF und UMDF]
Die WDF_MEMORY_DESCRIPTOR-Struktur beschreibt einen Speicherpuffer.
Syntax
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;
Member
Type
Ein WDF_MEMORY_DESCRIPTOR_TYPE typisierter Wert, der den Typ der Pufferbeschreibung angibt, den diese WDF_MEMORY_DESCRIPTOR-Struktur enthält.
u
Eine Vereinigung aus drei Strukturen, von denen eine einen Puffer beschreibt.
u.BufferType
Wenn das Type-ElementWdfMemoryDescriptorTypeBuffer ist, beschreiben die Member der BufferType-Struktur einen Puffer. Diese Struktur enthält die folgenden beiden Elemente:
u.BufferType.Buffer
Ein Zeiger auf einen Puffer.
u.BufferType.Length
Die Länge des Puffers in Bytes.
u.MdlType
Wenn das Type-ElementWdfMemoryDescriptorTypeMdl ist, beschreiben die Member der MdlType-Struktur einen Puffer. Diese Struktur enthält die folgenden beiden Elemente:
u.MdlType.Mdl
Ein Zeiger auf eine Speicherdeskriptorliste (Memory Descriptor List, MDL).
u.MdlType.BufferLength
Die Länge des Puffers in Bytes.
u.HandleType
Wenn das Type-ElementWdfMemoryDescriptorTypeHandle ist, beschreiben die Member der HandleType-Struktur einen Puffer. Diese Struktur enthält die folgenden beiden Elemente:
u.HandleType.Memory
Ein Handle für ein Frameworkspeicherobjekt.
u.HandleType.Offsets
Ein Zeiger auf eine WDFMEMORY_OFFSET-Struktur , die einen Unterabschnitt des Puffers beschreibt, der durch das Speicherobjekt dargestellt wird.
Hinweise
Die WDF_MEMORY_DESCRIPTOR-Struktur wird als Eingabe für mehrere E/A-Zielobjektmethoden des Frameworks und USB-Geräteobjektmethoden verwendet.
Um eine WDF_MEMORY_DESCRIPTOR-Struktur zu initialisieren, sollte Ihr Treiber WDF_MEMORY_DESCRIPTOR_INIT_BUFFER oder WDF_MEMORY_DESCRIPTOR_INIT_MDL oder WDF_MEMORY_DESCRIPTOR_INIT_HANDLE aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfmemory.h (einschließen von Wdf.h) |