struktur WDF_OBJECT_CONTEXT_TYPE_INFO (wdfobject.h)

Artikel
02/27/2024

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_OBJECT_CONTEXT_TYPE_INFO menjelaskan memori konteks yang ditentukan driver objek kerangka kerja.

Sintaks

typedef struct _WDF_OBJECT_CONTEXT_TYPE_INFO {
  ULONG                          Size;
  LPCSTR                         ContextName;
  size_t                         ContextSize;
  PCWDF_OBJECT_CONTEXT_TYPE_INFO UniqueType;
  PFN_GET_UNIQUE_CONTEXT_TYPE    EvtDriverGetUniqueContextType;
} WDF_OBJECT_CONTEXT_TYPE_INFO, *PWDF_OBJECT_CONTEXT_TYPE_INFO;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

ContextName

String yang dikutip yang mewakili nama struktur yang ditentukan driver yang berisi informasi konteks objek.

ContextSize

Ukuran, dalam byte, dari struktur yang ditentukan anggota ContextName . Kerangka kerja mengalokasikan ruang untuk struktur ini saat membuat objek. Jika anggota ContextSizeOverride dari struktur WDF_OBJECT_ATTRIBUTES bukan nol, nilainya akan menggantikan nilai dalam anggota ContextSize .

UniqueType

Untuk penggunaan internal.

EvtDriverGetUniqueContextType

Untuk penggunaan internal.

Keterangan

Untuk setiap instans objek, kerangka kerja mengalokasikan memori konteks dengan ukuran yang didasarkan pada nilai anggota ContextSize atau nilai anggota ContextSizeOverride dari struktur WDF_OBJECT_ATTRIBUTES .

Untuk membuat dan menginisialisasi struktur WDF_OBJECT_CONTEXT_TYPE_INFO, driver harus menggunakan makro WDF_DECLARE_CONTEXT_TYPE atau makro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME .

Untuk menyisipkan penunjuk ke struktur ini ke dalam struktur WDF_OBJECT_ATTRIBUTES, driver harus menggunakan makro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE .

Untuk informasi selengkapnya tentang menggunakan makro ini, lihat Ruang Konteks Objek Kerangka Kerja.