Metode IWDFIoRequest3::SetUserModeDriverInitiatedIo (wudfddi.h)

  • Artikel

[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 SetUserModeDriverInitiatedIo

menunjukkan kepada driver mode kernel yang duduk di bawah driver UMDF di tumpukan perangkat yang sama bahwa permintaan tertentu harus diperlakukan seolah-olah berasal dari driver UMDF.

Sintaks

void SetUserModeDriverInitiatedIo(
  [in] BOOL IsUserModeDriverInitiated
);

Parameter

[in] IsUserModeDriverInitiated

Nilai Boolean yang, jika TRUE, menunjukkan bahwa permintaan harus diperlakukan seolah-olah dimulai oleh driver UMDF. Jika FALSE, parameter ini menunjukkan bahwa permintaan harus diperlakukan seolah-olah berasal dari aplikasi.

Nilai kembali

Tidak ada

Keterangan

Jika driver UMDF memanggil metode ini dengan parameter IsUserModeDriverInitiated diatur ke TRUE, kerangka kerja mengatur bendera IRP_UM_DRIVER_INITIATED_IO di anggota Bendera struktur IRP WDM sebelum meneruskan permintaan ke driver mode kernel.

Driver mode kernel yang berada di bawah driver UMDF di tumpukan perangkat yang sama dapat memeriksa bendera ini untuk menentukan apakah permintaan harus diperlakukan seolah-olah dimulai oleh driver UMDF.

Bendera ini tidak berlaku untuk driver mode kernel yang mungkin menerima permintaan dari driver UMDF melalui target I/O handel file atau target I/O Win32.

Driver UMDF mungkin mengatur parameter IsUserModeDriverInitiated ke TRUE untuk permintaan yang berasal dari aplikasi jika driver telah memvalidasi permintaan.

Permintaan bahwa driver yang dibuat sendiri sudah ditandai sebagai berasal dari driver UMDF.

UMDF 2 yang setara dengan metode ini adalah WdfRequestSetUserModeDriverInitiatedIo.

Persyaratan

Persyaratan Nilai
Akhir dukungan Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform Desktop
Versi UMDF minimum 1.11
Header wudfddi.h (termasuk Wudfddi.h)
DLL WUDFx.dll

Lihat juga

GetUserModeDriverInitiatedIo

IWDFIoRequest3

WdfRequestSetUserModeDriverInitiatedIo