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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk