makro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE

[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.

Sintaksis

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Parameter-parameternya

_attributes
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES.

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

Mengembalikan nilai

Makro ini tidak mengembalikan nilai.

Komentar

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 );

Persyaratan

Platform sasaran	Universal
Versi KMDF minimum	1.0
Versi UMDF minimum	2.0
Penanda kepala	Wdfobject.h (termasuk Wdf.h)

Lihat juga

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE