Fungsi WdfDeviceInitSetRequestAttributes (wdfdevice.h)

Artikel
02/29/2024

[Berlaku untuk KMDF dan UMDF]

Metode WdfDeviceInitSetRequestAttributes mengatur atribut objek yang akan digunakan untuk semua objek permintaan kerangka kerja yang dikirimkan kerangka kerja ke driver dari antrean I/O perangkat.

Sintaks

void WdfDeviceInitSetRequestAttributes(
  [in] PWDFDEVICE_INIT        DeviceInit,
  [in] PWDF_OBJECT_ATTRIBUTES RequestAttributes
);

Parameter

[in] DeviceInit

Penunjuk yang disediakan penelepon ke struktur WDFDEVICE_INIT .

[in] RequestAttributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan penelepon yang berisi atribut untuk objek permintaan perangkat.

Nilai kembali

Tidak ada

Keterangan

Driver Anda dapat memanggil WdfDeviceInitSetRequestAttributes untuk menentukan ruang konteks objek yang akan ditetapkan kerangka kerja ke objek permintaan yang dibuatnya untuk driver Anda. Untuk informasi selengkapnya tentang ruang konteks ini, lihat Menggunakan Konteks Objek Permintaan.

Kerangka kerja tidak menggunakan atribut objek yang ditentukan untuk objek permintaan yang dibuatnya saat driver memanggil WdfRequestCreate atau WdfRequestCreateFromIrp.

Driver Anda harus memanggil WdfDeviceInitSetRequestAttributes dari dalam fungsi panggilan balik EvtDriverDeviceAdd , sebelum memanggil WdfDeviceCreate. Untuk informasi selengkapnya, lihat Membuat Objek Perangkat Kerangka Kerja.

Contoh

Contoh kode berikut menginisialisasi struktur WDF_OBJECT_ATTRIBUTES dan memanggil WdfDeviceInitSetRequestAttributes.

typedef struct _REQUEST_CONTEXT {
  ULONG_PTR  Information;
} REQUEST_CONTEXT, *PREQUEST_CONTEXT;
WDF_OBJECT_ATTRIBUTES  attributes;

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
                                        &attributes,
                                        REQUEST_CONTEXT
                                        );
WdfDeviceInitSetRequestAttributes(
                                  DeviceInit,
                                  &attributes
                                  );

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfdevice.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Lihat juga

EvtDriverDeviceAdd

Bagikan melalui