estrutura WDF_MEMORY_DESCRIPTOR (wdfmemory.h)

[Aplica-se a KMDF e UMDF]

A estrutura WDF_MEMORY_DESCRIPTOR descreve um buffer de memória.

Sintaxe

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;

Membros

Type

Um valor do tipo WDF_MEMORY_DESCRIPTOR_TYPE que identifica o tipo de descrição do buffer que essa estrutura WDF_MEMORY_DESCRIPTOR contém.

u

Uma união de três estruturas, uma das quais descreve um buffer.

u.BufferType

Se o membro Type for WdfMemoryDescriptorTypeBuffer, os membros da estrutura BufferType descreverão um buffer. Essa estrutura contém os dois membros a seguir:

u.BufferType.Buffer

Um ponteiro para um buffer.

u.BufferType.Length

O comprimento, em bytes, do buffer.

u.MdlType

Se o membro Type for WdfMemoryDescriptorTypeMdl, os membros da estrutura MdlType descreverão um buffer. Essa estrutura contém os dois membros a seguir:

u.MdlType.Mdl

Um ponteiro para uma MDL (lista de descritores de memória).

u.MdlType.BufferLength

O comprimento, em bytes, do buffer.

u.HandleType

Se o membro Type for WdfMemoryDescriptorTypeHandle, os membros da estrutura HandleType descreverão um buffer. Essa estrutura contém os dois membros a seguir:

u.HandleType.Memory

Um identificador para um objeto de memória de estrutura.

u.HandleType.Offsets

Um ponteiro para uma estrutura WDFMEMORY_OFFSET que descreve uma subseção do buffer representada pelo objeto de memória.

Comentários

A estrutura WDF_MEMORY_DESCRIPTOR é usada como entrada para vários dos métodos de objeto de destino de E/S da estrutura e métodos de objeto de dispositivo USB.

Para inicializar uma estrutura de WDF_MEMORY_DESCRIPTOR , o driver deve chamar WDF_MEMORY_DESCRIPTOR_INIT_BUFFER, WDF_MEMORY_DESCRIPTOR_INIT_MDL ou WDF_MEMORY_DESCRIPTOR_INIT_HANDLE.

Requisitos

Requisito	Valor
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
Cabeçalho	wdfmemory.h (inclua Wdf.h)

Confira também

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE