estructura WDF_MEMORY_DESCRIPTOR (wdfmemory.h)

[Se aplica a KMDF y UMDF]

La estructura WDF_MEMORY_DESCRIPTOR describe un búfer de memoria.

Sintaxis

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;

Miembros

Type

Valor de tipo WDF_MEMORY_DESCRIPTOR_TYPE que identifica el tipo de descripción del búfer que contiene esta estructura de WDF_MEMORY_DESCRIPTOR .

u

Una unión de tres estructuras, una de las cuales describe un búfer.

u.BufferType

Si el miembro Type es WdfMemoryDescriptorTypeBuffer, los miembros de la estructura BufferType describen un búfer. Esta estructura contiene los dos miembros siguientes:

u.BufferType.Buffer

Puntero a un búfer.

u.BufferType.Length

Longitud, en bytes, del búfer.

u.MdlType

Si el miembro Type es WdfMemoryDescriptorTypeMdl, los miembros de la estructura MdlType describen un búfer. Esta estructura contiene los dos miembros siguientes:

u.MdlType.Mdl

Puntero a una lista de descriptores de memoria (MDL).

u.MdlType.BufferLength

Longitud, en bytes, del búfer.

u.HandleType

Si el miembro Type es WdfMemoryDescriptorTypeHandle, los miembros de la estructura HandleType describen un búfer. Esta estructura contiene los dos miembros siguientes:

u.HandleType.Memory

Identificador de un objeto de memoria de marco.

u.HandleType.Offsets

Puntero a una estructura de WDFMEMORY_OFFSET que describe una subsección del búfer representado por el objeto de memoria.

Comentarios

La estructura de WDF_MEMORY_DESCRIPTOR se usa como entrada para varios de los métodos de objeto de destino de E/S del marco y métodos de objetos de dispositivo USB.

Para inicializar una estructura de WDF_MEMORY_DESCRIPTOR, el controlador debe llamar a WDF_MEMORY_DESCRIPTOR_INIT_BUFFER, WDF_MEMORY_DESCRIPTOR_INIT_MDL o WDF_MEMORY_DESCRIPTOR_INIT_HANDLE.

Requisitos

Requisito	Value
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfmemory.h (incluir Wdf.h)

Consulte también

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE