EVT_WDF_DEVICE_FILE_CREATE fungsi panggilan balik (wdfdevice.h)
[Berlaku untuk KMDF dan UMDF]
Fungsi panggilan balik EvtDeviceFileCreate driver menangani operasi yang harus dilakukan ketika aplikasi meminta akses ke perangkat.
Sintaks
EVT_WDF_DEVICE_FILE_CREATE EvtWdfDeviceFileCreate;
void EvtWdfDeviceFileCreate(
[in] WDFDEVICE Device,
[in] WDFREQUEST Request,
[in] WDFFILEOBJECT FileObject
)
{...}
Parameter
[in] Device
Handel ke objek perangkat kerangka kerja.
[in] Request
Handel ke objek permintaan kerangka kerja yang mewakili permintaan pembuatan file.
[in] FileObject
Handel ke objek file kerangka kerja yang menjelaskan file yang sedang dibuka untuk permintaan yang ditentukan. Parameter ini adalah NULL jika driver telah menentukan WdfFileObjectNotRequired untuk anggota FileObjectClass dari struktur WDF_FILEOBJECT_CONFIG .
Nilai kembali
Tidak ada
Keterangan
Kerangka kerja memanggil fungsi panggilan balik EvtDeviceFileCreate driver saat aplikasi pengguna atau driver lain membuka perangkat untuk melakukan operasi I/O, seperti membaca atau menulis file.
Driver dapat meneruskan handel Permintaan ke WdfRequestGetParameters untuk mengambil parameter yang terkait dengan permintaan pembuatan file. Parameter disimpan dalam parameter.Buat anggota struktur WDF_REQUEST_PARAMETERS .
Fungsi panggilan balik ini disebut secara sinkron, dalam konteks utas yang membuka perangkat.
Untuk mendaftarkan fungsi panggilan balik EvtDeviceFileCreate , driver harus memanggil metode WdfDeviceInitSetFileObjectConfig .
Driver harus menyelesaikan permintaan atau mengirimkannya dengan WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET.
Atau, driver dapat menerima permintaan buat dalam antrean. Untuk informasi selengkapnya, lihat WdfDeviceConfigureRequestDispatching.
Untuk informasi selengkapnya tentang objek file kerangka kerja dan fungsi panggilan balik EvtDeviceFileCreate , lihat Objek File Kerangka Kerja.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Versi UMDF minimum | 2.0 |
| Header | wdfdevice.h (termasuk Wdf.h) |
| IRQL | PASSIVE_LEVEL |