struktur WDF_MEMORY_DESCRIPTOR (wdfmemory.h)

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_MEMORY_DESCRIPTOR menjelaskan buffer memori.

Sintaks

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;

Anggota

Type

Nilai jenis WDF_MEMORY_DESCRIPTOR_TYPE yang mengidentifikasi jenis deskripsi buffer yang dikandung struktur WDF_MEMORY_DESCRIPTOR ini.

u

Persatuan tiga struktur, salah satunya menggambarkan buffer.

u.BufferType

Jika anggota Jenis adalah WdfMemoryDescriptorTypeBuffer, anggota struktur BufferType menjelaskan buffer. Struktur ini berisi dua anggota berikut:

u.BufferType.Buffer

Penunjuk ke buffer.

u.BufferType.Length

Panjangnya, dalam byte, dari buffer.

u.MdlType

Jika anggota Jenis adalah WdfMemoryDescriptorTypeMdl, anggota struktur MdlType menjelaskan buffer. Struktur ini berisi dua anggota berikut:

u.MdlType.Mdl

Penunjuk ke daftar deskriptor memori (MDL).

u.MdlType.BufferLength

Panjangnya, dalam byte, dari buffer.

u.HandleType

Jika anggota Jenis adalah WdfMemoryDescriptorTypeHandle, anggota struktur HandleType menjelaskan buffer. Struktur ini berisi dua anggota berikut:

u.HandleType.Memory

Handel ke objek memori kerangka kerja.

u.HandleType.Offsets

Penunjuk ke struktur WDFMEMORY_OFFSET yang menjelaskan subbagian buffer yang diwakili oleh objek memori.

Keterangan

Struktur WDF_MEMORY_DESCRIPTOR digunakan sebagai input ke beberapa metode objek target I/O kerangka kerja dan metode objek perangkat USB.

Untuk menginisialisasi struktur WDF_MEMORY_DESCRIPTOR , driver Anda harus memanggil WDF_MEMORY_DESCRIPTOR_INIT_BUFFER, atau WDF_MEMORY_DESCRIPTOR_INIT_MDL, atau WDF_MEMORY_DESCRIPTOR_INIT_HANDLE.

Persyaratan

Persyaratan	Nilai
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfmemory.h (termasuk Wdf.h)

Lihat juga

WDFMEMORY_OFFSET

WDF_MEMORY_DESCRIPTOR_TYPE