структура 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

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

u.BufferType.Buffer

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

u.BufferType.Length

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

u.MdlType

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

u.MdlType.Mdl

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

u.MdlType.BufferLength

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

u.HandleType

Если элемент Type имеет значение 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.

Требования

Требование Значение
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfmemory.h (включая Wdf.h)

См. также раздел

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE