Metode IWDFIoRequest::GetReadParameters (wudfddi.h)

  • Artikel

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 GetReadParameters mengambil parameter permintaan untuk permintaan jenis baca.

Sintaks

void GetReadParameters(
  [out, optional] SIZE_T   *pSizeInBytes,
  [out, optional] LONGLONG *pullOffset,
  [out, optional] ULONG    *pulKey
);

Parameter

[out, optional] pSizeInBytes

Penunjuk ke variabel yang menerima ukuran, dalam byte, untuk dibaca. Untuk mengambil data untuk dibaca, driver memanggil metode IWDFIoRequest::GetOutputMemory .

Parameter ini bersifat opsional. Driver dapat melewati NULL jika tidak memerlukan informasi.

[out, optional] pullOffset

Penunjuk ke variabel yang menerima offset, dalam byte, untuk mulai membaca dari perangkat atau file pada perangkat. Jika perangkat tidak mendukung alamat baca absolut, pullOffset dapat diabaikan. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Aplikasi klien menentukan nilai ini di anggota Offset dan OffsetHigh dari struktur YANG TUMPANG TINDIH. Penunjuk ke TUMPANG TINDIH diteruskan dalam fungsi ReadFile atau ReadFileEx Microsoft Win32.

Parameter ini bersifat opsional. Driver dapat melewati NULL jika tidak memerlukan informasi.

[out, optional] pulKey

Penunjuk ke variabel yang menerima kunci yang dapat digunakan driver untuk mengurutkan permintaan I/O dengan cara yang ditentukan driver.

Parameter ini bersifat opsional. Driver dapat melewati NULL jika tidak memerlukan informasi.

Mengembalikan nilai

Tidak ada

Keterangan

Panggilan ke GetReadParameters gagal jika jenis permintaan bukan jenis baca.

Untuk perangkat yang mendukung penetapan alamat (misalnya, perangkat disk), nilai yang dirujuk parameter pullOffset biasanya merupakan offset byte ke dalam perangkat. Untuk perangkat yang tidak mendukung penetapan alamat (misalnya, port serial), driver dapat mengabaikan nilai pada pullOffset.

Meskipun driver dapat secara opsional menentukan NULL untuk setiap parameter pSizeInBytes, pullOffset, dan pulKey, driver harus menentukan setidaknya satu parameter non-NULL agar GetReadParameters berhasil dijalankan.

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

Lihat juga