WDF_MEMORY_DESCRIPTOR struttura (wdfmemory.h)

[Si applica a KMDF e UMDF]

La struttura WDF_MEMORY_DESCRIPTOR descrive un buffer di memoria.

Sintassi

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;

Members

Type

Valore WDF_MEMORY_DESCRIPTOR_TYPE tipizzato che identifica il tipo di descrizione del buffer contenente questa struttura WDF_MEMORY_DESCRIPTOR.

u

Unione di tre strutture, una delle quali descrive un buffer.

u.BufferType

Se il membro Type è WdfMemoryDescriptorTypeBuffer, i membri della struttura BufferType descrivono un buffer. Questa struttura contiene i due membri seguenti:

u.BufferType.Buffer

Puntatore a un buffer.

u.BufferType.Length

Lunghezza, in byte, del buffer.

u.MdlType

Se il membro Type è WdfMemoryDescriptorTypeMdl, i membri della struttura MdlType descrivono un buffer. Questa struttura contiene i due membri seguenti:

u.MdlType.Mdl

Puntatore a un elenco di descrittori di memoria (MDL).

u.MdlType.BufferLength

Lunghezza, in byte, del buffer.

u.HandleType

Se il membro Type è WdfMemoryDescriptorTypeHandle, i membri della struttura HandleType descrivono un buffer. Questa struttura contiene i due membri seguenti:

u.HandleType.Memory

Handle per un oggetto memoria framework.

u.HandleType.Offsets

Puntatore a una struttura WDFMEMORY_OFFSET che descrive una sottosezione del buffer rappresentata dall'oggetto memory.

Commenti

La struttura WDF_MEMORY_DESCRIPTOR viene usata come input per diversi metodi di oggetti di destinazione I/O del framework e metodi dell'oggetto dispositivo USB.

Per inizializzare una struttura WDF_MEMORY_DESCRIPTOR, il driver deve chiamare WDF_MEMORY_DESCRIPTOR_INIT_BUFFER o WDF_MEMORY_DESCRIPTOR_INIT_MDL o WDF_MEMORY_DESCRIPTOR_INIT_HANDLE.

Requisiti

Requisito	Valore
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfmemory.h (include Wdf.h)

Vedi anche

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE