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)

Weitere Informationen

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE