Bagikan melalui


Metode IWDFIoRequest::GetWriteParameters (wudfddi.h)

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 GetWriteParameters mengambil parameter permintaan untuk permintaan jenis tulis.

Sintaks

void GetWriteParameters(
  [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 menulis. Untuk mengambil data untuk menulis, driver memanggil metode IWDFIoRequest::GetInputMemory .

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 menulis ke perangkat atau file di perangkat. Jika perangkat tidak mendukung alamat tulis 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 Microsoft Win32 WriteFile atau WriteFileEx .

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 GetWriteParameters gagal jika jenis permintaan bukan jenis tulis.

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.

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