WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE makro

Artikel
06/15/2023

[Berlaku untuk KMDF dan UMDF]

Makro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE menginisialisasi struktur WDF_OBJECT_ATTRIBUTES driver dan menyisipkan informasi konteks yang ditentukan driver objek ke dalam struktur.

Sintaks

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Parameter

_Atribut
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES .

_contexttype
Nama jenis struktur struktur yang ditentukan driver yang menjelaskan konten ruang konteks objek.

Menampilkan nilai

Makro ini tidak mengembalikan nilai.

Keterangan

Sebelum memanggil WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE, Anda harus memanggil WDF_DECLARE_CONTEXT_TYPE atau WDF_DECLARE_CONTEXT_TYPE_WITH_NAME secara global (tidak dalam fungsi).

Makro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE menggabungkan fungsi WDF_OBJECT_ATTRIBUTES_INIT dan makro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE .

Contoh

Contoh kode berikut mendefinisikan struktur konteks WDM_NDIS_REQUEST. Kemudian, contoh memanggil makro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME untuk mendaftarkan struktur dan menentukan bahwa metode pengakses konteks akan diberi nama RequestGetMyContext. Kemudian, dalam fungsi, contoh mengalokasikan struktur WDF_OBJECT_ATTRIBUTES , lalu menginisialisasi struktur WDF_OBJECT_ATTRIBUTES .

typedef struct _WDM_NDIS_REQUEST
{
   PMP_ADAPTER  Adapter;
   NDIS_OID  Oid;
   NDIS_REQUEST_TYPE  RequestType;
   PVOID  InformationBuffer;
   ULONG  InformationBufferLength;
   PULONG  BytesReadOrWritten;
   PULONG  BytesNeeded;
} WDM_NDIS_REQUEST, *PWDM_NDIS_REQUEST;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(WDM_NDIS_REQUEST, RequestGetMyContext);

// above are in global space

...

WDF_OBJECT_ATTRIBUTES  attributes;

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE( &attributes, WDM_NDIS_REQUEST );