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;
Elemente
Type
Ein WDF_MEMORY_DESCRIPTOR_TYPE-typed-Wert, der den Typ der Pufferbeschreibung identifiziert, die diese WDF_MEMORY_DESCRIPTOR Struktur enthält.
u
Eine Vereinigung von drei Strukturen, von denen einer einen Puffer beschreibt.
u.BufferType
Wenn der Type Member WdfMemoryDescriptorTypeBufferist, 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 der Type Member WdfMemoryDescriptorTypeMdlist, beschreiben die Member der MdlType- Struktur einen Puffer. Diese Struktur enthält die folgenden beiden Elemente:
u.MdlType.Mdl
Ein Zeiger auf eine Speicherdeskriptorliste (MDL).
u.MdlType.BufferLength
Die Länge des Puffers in Bytes.
u.HandleType
Wenn der Type Member WdfMemoryDescriptorTypeHandleist, beschreiben die Member der HandleType--Struktur einen Puffer. Diese Struktur enthält die folgenden beiden Elemente:
u.HandleType.Memory
Ein Handle für ein Framework-Speicherobjekt.
u.HandleType.Offsets
Ein Zeiger auf eine WDFMEMORY_OFFSET-Struktur, die einen Unterabschnitt des Puffers beschreibt, der durch das Speicherobjekt dargestellt wird.
Bemerkungen
Die WDF_MEMORY_DESCRIPTOR-Struktur wird als Eingabe für mehrere der I/O-Zielobjektmethoden des Frameworks und USB-Geräteobjektmethodenverwendet.
Um eine WDF_MEMORY_DESCRIPTOR-Struktur zu initialisieren, sollte Ihr Treiber WDF_MEMORY_DESCRIPTOR_INIT_BUFFERoder WDF_MEMORY_DESCRIPTOR_INIT_MDLoder WDF_MEMORY_DESCRIPTOR_INIT_HANDLEaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Kopfzeile | wdfmemory.h (include Wdf.h) |