Fungsi WdfIoQueueRetrieveRequestByFileObject (wdfio.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfIoQueueRetrieveRequestByFileObject mengambil permintaan I/O berikutnya yang tersedia, dari antrean I/O tertentu, yang terkait dengan objek file tertentu.

Sintaks

NTSTATUS WdfIoQueueRetrieveRequestByFileObject(
  [in]  WDFQUEUE      Queue,
  [in]  WDFFILEOBJECT FileObject,
  [out] WDFREQUEST    *OutRequest
);

Parameter

[in] Queue

Handel ke objek antrean kerangka kerja.

[in] FileObject

Handel ke objek file kerangka kerja.

[out] OutRequest

Penunjuk ke lokasi yang menerima handel ke objek permintaan kerangka kerja. Jika WdfIoQueueRetrieveRequestByFileObject tidak mengembalikan STATUS_SUCCESS, itu tidak mengatur nilai lokasi.

Nilai kembali

WdfIoQueueRetrieveRequestByFileObject mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Driver menyediakan handel yang tidak valid.
STATUS_NO_MORE_ENTRIES	Kerangka kerja mencapai akhir antrean I/O.
STATUS_INVALID_DEVICE_STATE	Antrean I/O yang ditentukan dikonfigurasi untuk metode pengiriman paralel.
STATUS_WDF_PAUSED	Antrean I/O yang ditentukan dikelola daya dan perangkatnya dalam keadaan daya rendah.

 

Metode ini juga dapat mengembalikan nilai NTSTATUS lainnya.

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

Keterangan

Driver yang telah mengonfigurasi antrean I/O untuk pengiriman manual atau berurutan mungkin memanggil WdfIoQueueRetrieveRequestByFileObject. Untuk informasi selengkapnya tentang menggunakan WdfIoQueueRetrieveRequestByFileObject dengan metode pengiriman manual atau berurutan, lihat Metode Pengiriman untuk Permintaan I/O.

Setelah memanggil WdfIoQueueRetrieveRequestByFileObject untuk mendapatkan permintaan I/O, driver memiliki permintaan dan harus memproses permintaan I/O dengan cara tertentu.

Untuk informasi selengkapnya tentang metode WdfIoQueueRetrieveRequestByFileObject , lihat Mengelola Antrean I/O.

Contoh

Contoh kode berikut memperoleh, dari antrean I/O tertentu, handel ke objek permintaan kerangka kerja berikutnya yang terkait dengan objek file kerangka kerja tertentu.

WDFREQUEST  request;

status = WdfIoQueueRetrieveRequestByFileObject(
                                               queue,
                                               fileObject,
                                               &request
                                               );

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfio.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	DoubleCompletion(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WdfIoQueueRetrieveFoundRequest

WdfIoQueueRetrieveNextRequest