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) |