структура WDF_MEMORY_DESCRIPTOR (wdfmemory.h)

[Применимо к KMDF и UMDF]

Структура WDF_MEMORY_DESCRIPTOR описывает буфер памяти.

Синтаксис

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;

Члены

Type

Значение типа WDF_MEMORY_DESCRIPTOR_TYPE, определяющее тип описания буфера, содержащего эту структуру WDF_MEMORY_DESCRIPTOR.

u

Объединение трех структур, одно из которых описывает буфер.

u.BufferType

Если элемент типаWdfMemoryDescriptorTypeBuffer, члены структуры буферного типа описывают буфер. Эта структура содержит следующие два элемента:

u.BufferType.Buffer

Указатель на буфер.

u.BufferType.Length

Длина буфера в байтах.

u.MdlType

Если элемент типаWdfMemoryDescriptorTypeMdl, члены структуры MdlType описывают буфер. Эта структура содержит следующие два элемента:

u.MdlType.Mdl

Указатель на список дескрипторов памяти (MDL).

u.MdlType.BufferLength

Длина буфера в байтах.

u.HandleType

Если элемент типаWdfMemoryDescriptorTypeHandle, члены структуры handleType описывают буфер. Эта структура содержит следующие два элемента:

u.HandleType.Memory

Дескриптор объекта памяти платформы.

u.HandleType.Offsets

Указатель на структуру WDFMEMORY_OFFSET, описывающую подраздел буфера, представленного объектом памяти.

Замечания

Структура WDF_MEMORY_DESCRIPTOR используется в качестве входных данных для нескольких методов целевых объектов платформы и методов объекта USB-устройства.

Чтобы инициализировать структуру WDF_MEMORY_DESCRIPTOR, драйвер должен вызывать WDF_MEMORY_DESCRIPTOR_INIT_BUFFERили WDF_MEMORY_DESCRIPTOR_INIT_MDLили WDF_MEMORY_DESCRIPTOR_INIT_HANDLE.

Требования

См. также

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE