EVT_WDF_IO_ALLOCATE_REQUEST_RESOURCES fungsi panggilan balik (wdfio.h)
[Hanya berlaku untuk KMDF]
Fungsi panggilan balik EvtIoAllocateRequestResources driver mengalokasikan sumber daya khusus permintaan yang diperlukan driver untuk memproses permintaan yang ditentukan.
Sintaks
EVT_WDF_IO_ALLOCATE_REQUEST_RESOURCES EvtWdfIoAllocateRequestResources;
NTSTATUS EvtWdfIoAllocateRequestResources(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request
)
{...}
Parameter
[in] Queue
Handel ke objek antrean I/O.
[in] Request
Handel ke objek permintaan yang telah dibuat kerangka kerja. Kerangka kerja belum menambahkan objek permintaan ke antrean I/O yang ditentukan oleh handel parameter Antrean .
Nilai kembali
Fungsi panggilan balik EvtIoAllocateRequestResources harus mengembalikan STATUS_SUCCESS atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE jika fungsi tidak mengalami kesalahan. Jika tidak, fungsi ini harus mengembalikan nilai status yang NT_SUCCESS(status) sama dengan FALSE.
Keterangan
Driver dapat mendaftarkan fungsi panggilan balik EvtIoAllocateRequestResources saat memanggil WdfIoQueueAssignForwardProgressPolicy.
Jika driver Anda mendaftarkan fungsi panggilan balik EvtIoAllocateRequestResources , kerangka kerja memanggil fungsi segera setelah membuat objek permintaan untuk paket permintaan I/O (IRP) yang telah dikirim manajer I/O ke driver Anda.
Fungsi panggilan balik dapat mengalokasikan sumber daya yang akan diperlukan driver Anda untuk memproses permintaan nanti, setelah driver memperoleh objek permintaan dari antrean I/O yang ditentukan oleh handel parameter Antrean .
Jika fungsi panggilan balik berhasil mengalokasikan sumber daya dan mengembalikan STATUS_SUCCESS, kerangka kerja pada akhirnya akan mengirimkan objek permintaan ke driver.
Jika terjadi kesalahan alokasi sumber daya, seperti situasi memori rendah, fungsi panggilan balik harus mengembalikan nilai status kesalahan. Dalam hal ini, kerangka kerja mengikuti kebijakan kemajuan maju driver, yang sebelumnya ditentukan driver dengan nilai WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY ketika disebut WdfIoQueueAssignForwardProgressPolicy.
Untuk informasi selengkapnya tentang fungsi panggilan balik EvtIoAllocateRequestResources , lihat Menjamin Kemajuan Penerusan Operasi I/O.
Fungsi panggilan balik ini dapat dipanggil di IRQL <= DISPATCH_LEVEL. Jika IRQL PASSIVE_LEVEL, kerangka kerja memanggil fungsi panggilan balik dalam wilayah penting.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1.9 |
| Header | wdfio.h (termasuk Wdf.h) |
| IRQL | <=DISPATCH_LEVEL (lihat bagian Keterangan) |