Fungsi WdfDeviceInitSetFileObjectConfig (wdfdevice.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfDeviceInitSetFileObjectConfig mendaftarkan fungsi panggilan balik peristiwa dan mengatur informasi konfigurasi untuk objek file kerangka kerja driver.
Sintaks
void WdfDeviceInitSetFileObjectConfig(
[in] PWDFDEVICE_INIT DeviceInit,
[in] PWDF_FILEOBJECT_CONFIG FileObjectConfig,
[in, optional] PWDF_OBJECT_ATTRIBUTES FileObjectAttributes
);
Parameter
[in] DeviceInit
Penunjuk ke struktur WDFDEVICE_INIT .
[in] FileObjectConfig
Penunjuk ke struktur WDF_FILEOBJECT_CONFIG yang dialokasikan penelepon.
[in, optional] FileObjectAttributes
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan penelepon yang berisi atribut objek yang disediakan driver untuk objek file kerangka kerja driver. Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.
Nilai kembali
Tidak ada
Keterangan
Jika driver memanggil WdfDeviceInitSetFileObjectConfig, driver harus melakukannya sebelum memanggil WdfDeviceCreate.
Secara default, setiap objek file kerangka kerja mewarisi cakupan sinkronisasi dan tingkat eksekusinya dari objek perangkat induknya. Jika cakupan sinkronisasi dan tingkat eksekusi objek perangkat induk bukan WdfSynchronizationScopeNone dan WdfExecutionLevelPassive, driver harus mengatur nilai WdfSynchronizationScopeNone dan WdfExecutionLevelPassive dalam struktur WDF_OBJECT_ATTRIBUTES yang ditentukan parameter FileObjectAttributes . Jika tidak, WdfDeviceCreate akan mengembalikan kode status kesalahan. Untuk informasi selengkapnya tentang cakupan sinkronisasi dan tingkat eksekusi, lihat Menggunakan Sinkronisasi Otomatis.
Untuk informasi selengkapnya tentang memanggil WdfDeviceCreate, lihat Membuat Objek Perangkat Kerangka Kerja.
Untuk informasi selengkapnya tentang objek file kerangka kerja, lihat Objek File Kerangka Kerja
Contoh
Contoh kode berikut menginisialisasi struktur WDF_OBJECT_ATTRIBUTES dan struktur WDF_FILEOBJECT_CONFIG lalu memanggil WdfDeviceInitSetFileObjectConfig.
WDF_OBJECT_ATTRIBUTES attributes;
WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.SynchronizationScope = WdfSynchronizationScopeNone;
WDF_FILEOBJECT_CONFIG_INIT(
&deviceConfig,
MyEvtDeviceFileCreate,
MyEvtFileClose,
WDF_NO_EVENT_CALLBACK // No cleanup callback function
);
WdfDeviceInitSetFileObjectConfig(
DeviceInit,
&deviceConfig,
&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), FileObjectConfigured(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |