Metode IWDFIoTarget::FormatRequestForRead (wudfddi.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti 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 FormatRequestForRead memformat objek permintaan I/O untuk operasi baca.
Sintaks
HRESULT FormatRequestForRead(
[in] IWDFIoRequest *pRequest,
[in, optional] IWDFFile *pFile,
[in, optional] IWDFMemory *pOutputMemory,
[in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset,
[in, optional] PLONGLONG DeviceOffset
);
Parameter
[in] pRequest
Penunjuk ke antarmuka IWDFIoRequest untuk objek permintaan yang akan diformat.
[in, optional] pFile
Penunjuk ke antarmuka IWDFFile untuk objek file yang terkait dengan permintaan baca. Untuk target I/O default, parameter ini harus non-NULL.
[in, optional] pOutputMemory
Penunjuk ke antarmuka IWDFMemory yang digunakan untuk mengakses buffer yang digunakan untuk permintaan baca. Parameter ini bersifat opsional.
[in, optional] pOutputMemoryOffset
Penunjuk ke struktur WDFMEMORY_OFFSET yang menjelaskan offset memori output yang digunakan untuk bacaan. Parameter ini bersifat opsional.
[in, optional] DeviceOffset
Penunjuk ke offset perangkat yang digunakan untuk bacaan. Parameter ini bersifat opsional.
Mengembalikan nilai
FormatRequestForRead mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang didefinisikan dalam Winerror.h.
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 |