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)

Voir aussi

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE