enumerasi WDF_FILEOBJECT_CLASS (wdfdevice.h)

Artikel
06/01/2023

[Berlaku untuk KMDF dan UMDF]

Enumerasi WDF_FILEOBJECT_CLASS menentukan nilai yang mengidentifikasi apakah driver memerlukan objek file kerangka kerja untuk mewakili file yang coba dibuat atau dibuka oleh aplikasi atau driver lain. Nilai-nilai ini juga menentukan di mana kerangka kerja dapat menyimpan handel objek.

Sintaks

typedef enum _WDF_FILEOBJECT_CLASS {
  WdfFileObjectInvalid = 0,
  WdfFileObjectNotRequired = 1,
  WdfFileObjectWdfCanUseFsContext = 2,
  WdfFileObjectWdfCanUseFsContext2 = 3,
  WdfFileObjectWdfCannotUseFsContexts = 4,
  WdfFileObjectCanBeOptional = 0x80000000
} WDF_FILEOBJECT_CLASS, *PWDF_FILEOBJECT_CLASS;

Konstanta


`WdfFileObjectInvalid` Nilai: 0 Dicadangkan untuk penggunaan internal.
`WdfFileObjectNotRequired` Nilai: 1 Driver tidak memerlukan objek file kerangka kerja.
`WdfFileObjectWdfCanUseFsContext` Nilai: 2 Driver memerlukan objek file kerangka kerja. Kerangka kerja dapat menyimpan handel objek di anggota FsContext dari struktur FILE_OBJECT Windows Driver Model (WDM) file.
`WdfFileObjectWdfCanUseFsContext2` Nilai: 3 Driver memerlukan objek file kerangka kerja. Kerangka kerja dapat menyimpan handel objek di anggota FsContext2 dari struktur FILE_OBJECT WDM file.
`WdfFileObjectWdfCannotUseFsContexts` Nilai: 4 Driver memerlukan objek file kerangka kerja. Kerangka kerja tidak dapat menyimpan handel objek di anggota FsContext atau FsContext2 dari struktur FILE_OBJECT WDM file, karena satu atau beberapa driver menggunakan anggota ini. Oleh karena itu, kerangka kerja harus menyimpan handel secara internal.
`WdfFileObjectCanBeOptional` Nilai: 0x80000000 Driver biasanya memerlukan objek file kerangka kerja, tetapi driver juga dapat menangani situasi khusus di mana objek file kerangka kerja hilang atau berbeda. Untuk informasi selengkapnya tentang situasi ini, lihat bagian Keterangan berikut ini. WdfFileObjectCanBeOptional adalah bendera bit yang dapat ATAU oleh driver Anda dengan nilai enumerator WdfFileObjectWdfCanUseFsContext, WdfFileObjectWdfCanfsContext2, atau WdfFileObjectWdfCannotUseFsContexts . Sebagian besar driver berbasis kerangka kerja tidak menggunakan bendera bit ini. Nilai WdfFileObjectCanBeOptional tersedia di KMDF versi 1.9 dan yang lebih baru.

Keterangan

Enumerasi WDF_FILEOBJECT_CLASS digunakan dalam struktur WDF_FILEOBJECT_CONFIG .

Jika driver Anda memanggil WdfRequestGetFileObject untuk mendapatkan objek file kerangka kerja untuk permintaan I/O, dan jika Anda tahu bahwa beberapa paket permintaan (IRP) WDM I/O yang diterima driver Anda tidak menyertakan objek file WDM, driver dapat mengatur bendera bit WdfFileObjectCanBeOptional .

Jika driver Anda mengatur WdfFileObjectWdfCanUseFsContext, Nilai WdfFileObjectWdfCanUseFsContext2, atau WdfFileObjectWdfCannotUseFsContexts dan tidak mengatur bendera bit WdfFileObjectCanBeOptional , pemverifikasi kerangka kerja melaporkan kesalahan untuk kasus berikut ketika driver memanggil metode WdfRequestGetFileObject :

IRP tidak menyertakan objek file WDM.
IRP menyertakan objek file WDM, tetapi objek file berbeda dari objek yang disertakan IRP pembuatan file.

Jika bendera bit WdfFileObjectCanBeOptional diatur, pemverifikasi kerangka kerja mengabaikan kasus tersebut.

Persyaratan

Persyaratan	Nilai
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfdevice.h (termasuk Wdf.h)

Lihat juga

FILE_OBJECT

WDF_FILEOBJECT_CONFIG

Bagikan melalui