Fungsi WdfDeviceInitSetFileObjectConfig (wdfdevice.h)

  • Artikel

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

Lihat juga

WDF_FILEOBJECT_CONFIG_INIT

WDF_OBJECT_ATTRIBUTES_INIT

WdfFdoInitSetEventCallbacks

WdfPdoInitSetEventCallbacks