Metode IWDFIoQueue::RetrieveNextRequestByFileObject (wudfddi.h)

Artikel
08/08/2023

Peringatan

UMDF 2 adalah versi terbaru UMDF dan supersedes UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.

Metode RetrieveNextRequestByFileObject mengambil dari antrean I/O permintaan I/O berikutnya yang objek filenya cocok dengan objek file yang ditentukan.

Sintaks

HRESULT RetrieveNextRequestByFileObject(
  [in]  IWDFFile      *pFile,
  [out] IWDFIoRequest **ppRequest
);

Parameter

[in] pFile

Penunjuk ke antarmuka IWDFFile untuk objek file yang digunakan untuk mengambil permintaan I/O berikutnya yang objek filenya cocok dengan objek file yang disediakan ini.

[out] ppRequest

Penunjuk ke buffer yang menerima penunjuk ke antarmuka IWDFIoRequest untuk objek permintaan berikutnya yang objek filenya cocok dengan objek file yang disediakan, atau menerima NULL jika antrean kosong atau jika permintaan berikutnya tidak ditemukan.

Nilai kembali

RetrieveNextRequestByFileObject mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
S_OK	Permintaan I/O berikutnya berhasil diambil dari antrean I/O.
HRESULT_FROM_NT(STATUS_WDF_PAUSED)	Antrean tidak mengirimkan permintaan. Situasi ini terjadi jika perangkat mengalami transisi status daya dan semua antrean dihentikan dari permintaan pengiriman atau jika driver secara eksplisit disebut IWDFIoQueue::Stop untuk menghentikan pengiriman permintaan. Situasi ini juga dapat terjadi jika driver mencoba menghapus permintaan dari antrean manual yang dikelola daya dan yang dimatikan atau jika antrean dijeda.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Tidak ada permintaan dalam antrean.
HRESULT_FROM_NT(STATUS_INVALID_DEVICE_STATE)	Panggilan dilakukan untuk mengambil permintaan dari antrean paralel.

RetrieveNextRequestByFileObject mungkin juga mengembalikan nilai HRESULT lainnya.

Keterangan

Jika driver mengonfigurasi antrean I/O untuk pengiriman manual permintaan I/O, driver dapat memanggil metode RetrieveNextRequestByFileObject untuk mendapatkan permintaan berikutnya yang objek filenya cocok dengan objek file yang disediakan dari antrean. Untuk informasi selengkapnya tentang mengirimkan permintaan I/O secara manual, lihat Mengonfigurasi Mode Pengiriman untuk Antrean I/O.

Jika beberapa permintaan I/O yang objek filenya cocok dengan objek file yang ditujukan parameter pFile dalam antrean I/O, permintaan I/O pertama dikembalikan.

Contoh

Untuk contoh kode tentang cara menggunakan metode RetrieveNextRequestByFileObject , lihat IWDFIoQueue::RetrieveNextRequest.

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1,5
Header	wudfddi.h (termasuk Wudfddi.h)
DLL	WUDFx.dll

Bagikan melalui