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 WDF_MEMORY_DESCRIPTOR_TYPE-typée qui identifie le type de description de la 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 vers un objet de mémoire de 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 méthodes d’objet d’appareil USB.

Pour initialiser une structure de WDF_MEMORY_DESCRIPTOR, votre pilote doit appeler WDF_MEMORY_DESCRIPTOR_INIT_BUFFER, ou WDF_MEMORY_DESCRIPTOR_INIT_MDL, ou WDF_MEMORY_DESCRIPTOR_INIT_HANDLE.

Spécifications

Voir aussi

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE