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.

Mengembalikan nilai

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 mungkin 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

   
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