Metode IWDFIoRequest::GetInputMemory (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 GetInputMemory mengambil objek memori yang mewakili buffer input dalam permintaan I/O.
Sintaks
void GetInputMemory(
[out] IWDFMemory **ppWdfMemory
);
Parameter
[out] ppWdfMemory
Pointer ke variabel yang menerima pointer ke antarmuka IWDFMemory yang dihitung referensi untuk objek memori. Perhatikan bahwa mengembalikan NULL valid; dalam situasi ini, tidak ada memori input yang terkait dengan permintaan I/O.
Nilai kembali
Tidak ada
Keterangan
Driver yang menggunakan metode akses I/O yang di-buffer dapat memanggil GetInputMemory untuk mendapatkan buffer input permintaan I/O.
Sebelum driver menyelesaikan permintaan I/O, driver harus memanggil metode IWDFMemory::Release untuk objek memori. Objek memori yang mendasar dibebaskan ketika permintaan selesai.
Buffer input yang terkait dengan permintaan I/O berisi informasi (misalnya, data yang akan ditulis ke disk) yang disediakan oleh penciut permintaan. Driver dapat memanggil GetInputMemory untuk mendapatkan buffer input untuk permintaan tulis atau permintaan kontrol I/O perangkat, tetapi tidak untuk permintaan baca (karena permintaan baca tidak menyediakan data input). Untuk mengakses buffer input, driver harus memanggil metode IWDFMemory::GetDataBuffer .
UMDF membuat objek memori permintaan I/O saat menerima permintaan I/O, sebelum menambahkan permintaan I/O ke antrean I/O driver. Jika UMDF tidak dapat mengalokasikan memori untuk objek memori, UMDF menyelesaikan permintaan I/O dengan status pengembalian kegagalan dan tidak mengirimkan permintaan I/O ke driver.
Untuk informasi selengkapnya tentang mengakses buffer data permintaan I/O, lihat Mengakses Buffer Data di Driver UMDF-Based.
Contoh
Untuk contoh kode tentang cara menggunakan metode GetInputMemory , lihat IWDFIoRequest::Complete.
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 |