Fungsi WdfDeviceSetSpecialFileSupport (wdfdevice.h)

Artikel
02/29/2024

[Hanya berlaku untuk KMDF]

Metode WdfDeviceSetSpecialFileSupport memungkinkan atau menonaktifkan dukungan driver fungsi untuk file khusus, untuk perangkat yang ditentukan.

Sintaks

void WdfDeviceSetSpecialFileSupport(
  [in] WDFDEVICE             Device,
  [in] WDF_SPECIAL_FILE_TYPE FileType,
  [in] BOOLEAN               FileTypeIsSupported
);

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] FileType

Enumerator jenis WDF_SPECIAL_FILE_TYPE yang mengidentifikasi jenis file khusus yang didukung driver.

[in] FileTypeIsSupported

Menyediakan nilai Boolean yang, jika TRUE, memungkinkan dukungan untuk jenis file khusus dan, jika FALSE, menonaktifkan dukungan jenis file khusus.

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Driver fungsi biasanya memanggil WdfDeviceSetSpecialFileSupport dari dalam fungsi panggilan balik EvtDriverDeviceAdd .

Dukungan setiap driver untuk file khusus awalnya dinonaktifkan sampai driver memanggil WdfDeviceSetSpecialFileSupport.

Untuk informasi selengkapnya, lihat Mendukung File Khusus.

Contoh

Contoh kode berikut memungkinkan dukungan untuk file halaman, hibernasi, dan cadangan pada perangkat.

WdfDeviceSetSpecialFileSupport(
                               device,
                               WdfSpecialFilePaging,
                               TRUE
                               );
WdfDeviceSetSpecialFileSupport(
                               device,
                               WdfSpecialFileHibernation,
                               TRUE
                               );
WdfDeviceSetSpecialFileSupport(
                               device,
                               WdfSpecialFileDump,
                               TRUE
                               );

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfdevice.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE

Bagikan melalui