Metode IWDFIoTarget::FormatRequestForIoctl (wudfddi.h)

Artikel
02/27/2024

[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 FormatRequestForIoctl memformat objek permintaan I/O untuk operasi kontrol I/O.

Sintaks

HRESULT FormatRequestForIoctl(
  [in]           IWDFIoRequest     *pRequest,
  [in]           ULONG             IoctlCode,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pInputMemory,
  [in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
  [in, optional] IWDFMemory        *pOutputMemory,
  [in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset
);

Parameter

[in] pRequest

Penunjuk ke antarmuka IWDFIoRequest agar objek permintaan dapat diformat.

[in] IoctlCode

Kode kontrol yang mengidentifikasi operasi tertentu untuk dilakukan.

[in, optional] pFile

Penunjuk ke antarmuka IWDFFile untuk objek file yang terkait dengan permintaan kontrol I/O. Untuk target I/O default, parameter ini harus non-NULL.

[in, optional] pInputMemory

Penunjuk ke antarmuka IWDFMemory yang digunakan untuk mengakses buffer input untuk permintaan tersebut. Parameter ini bersifat opsional.

[in, optional] pInputMemoryOffset

Penunjuk ke struktur WDFMEMORY_OFFSET yang menjelaskan offset memori input untuk permintaan tersebut. Parameter ini bersifat opsional.

[in, optional] pOutputMemory

Penunjuk ke antarmuka IWDFMemory yang digunakan untuk mengakses buffer output untuk permintaan tersebut. Parameter ini bersifat opsional.

[in, optional] pOutputMemoryOffset

Penunjuk ke struktur WDFMEMORY_OFFSET yang menjelaskan offset memori output untuk permintaan tersebut. Parameter ini bersifat opsional.

Nilai kembali

FormatRequestForIoctl mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang ditentukan 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

Lihat juga

Bagikan melalui