structure WDF_MEMORY_DESCRIPTOR (wdfmemory.h)
[S’applique à KMDF et UMDF]
La structure WDF_MEMORY_DESCRIPTOR décrit une mémoire tampon.
Syntaxe
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;
Membres
Type
Valeur de type WDF_MEMORY_DESCRIPTOR_TYPE qui identifie le type de description de mémoire tampon que contient cette structure WDF_MEMORY_DESCRIPTOR .
u
Union de trois structures, dont l’une décrit une mémoire tampon.
u.BufferType
Si le membre Type est WdfMemoryDescriptorTypeBuffer, les membres de la structure BufferType décrivent une mémoire tampon. Cette structure contient les deux membres suivants :
u.BufferType.Buffer
Pointeur vers une mémoire tampon.
u.BufferType.Length
Longueur, en octets, de la mémoire tampon.
u.MdlType
Si le membre Type est WdfMemoryDescriptorTypeMdl, les membres de la structure MdlType décrivent une mémoire tampon. Cette structure contient les deux membres suivants :
u.MdlType.Mdl
Pointeur vers une liste de descripteurs de mémoire (MDL).
u.MdlType.BufferLength
Longueur, en octets, de la mémoire tampon.
u.HandleType
Si le membre Type est WdfMemoryDescriptorTypeHandle, les membres de la structure HandleType décrivent une mémoire tampon. Cette structure contient les deux membres suivants :
u.HandleType.Memory
Handle d’un objet de mémoire framework.
u.HandleType.Offsets
Pointeur vers une structure WDFMEMORY_OFFSET qui décrit une sous-section de la mémoire tampon représentée par l’objet mémoire.
Remarques
La structure WDF_MEMORY_DESCRIPTOR est utilisée comme entrée dans plusieurs méthodes d’objet cible d’E/S de l’infrastructure et les méthodes d’objet d’appareil USB de l’infrastructure.
Pour initialiser une structure de WDF_MEMORY_DESCRIPTOR , votre pilote doit appeler WDF_MEMORY_DESCRIPTOR_INIT_BUFFER, WDF_MEMORY_DESCRIPTOR_INIT_MDL ou WDF_MEMORY_DESCRIPTOR_INIT_HANDLE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfmemory.h (include Wdf.h) |