IWDFIoRequest3::SetUserModeDriverInitiatedIo-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die SetUserModeDriverInitiatedIo-Methode

gibt kernelmodustreiber an, die sich unterhalb des UMDF-Treibers im selben Gerätestapel befinden und eine bestimmte Anforderung behandelt werden soll, als ob sie von einem UMDF-Treiber stammt.

Syntax

void SetUserModeDriverInitiatedIo(
  [in] BOOL IsUserModeDriverInitiated
);

Parameter

[in] IsUserModeDriverInitiated

Ein boolescher Wert, der bei TRUE angibt, dass die Anforderung so behandelt werden soll, als ob sie von einem UMDF-Treiber initiiert wurde. Bei FALSE gibt dieser Parameter an, dass die Anforderung so behandelt werden soll, als ob sie von einer Anwendung stammt.

Rückgabewert

Keine

Bemerkungen

Wenn ein UMDF-Treiber diese Methode aufruft, wobei der IsUserModeDriverInitiated-Parameter auf TRUE festgelegt ist, legt das Framework das IRP_UM_DRIVER_INITIATED_IO-Flag im Flags-Member der WDM-IRP-Struktur fest, bevor die Anforderung an Kernelmodustreiber weitergeleitet wird.

Ein Kernelmodustreiber, der sich unterhalb des UMDF-Treibers im selben Gerätestapel befindet, kann überprüfen, ob dieses Flag vorhanden ist, um zu ermitteln, ob die Anforderung wie von einem UMDF-Treiber initiiert behandelt werden soll.

Dieses Flag gilt nicht für Kernelmodustreiber, die möglicherweise eine Anforderung von einem UMDF-Treiber über ein Dateihandle-E/A-Ziel oder ein Win32-E/A-Ziel empfangen.

Ein UMDF-Treiber kann den Parameter IsUserModeDriverInitiated für eine Anforderung, die von einer Anwendung stammt, auf TRUE festlegen, wenn der Treiber die Anforderung überprüft hat.

Anforderungen, die der Treiber selbst erstellt hat, sind bereits als von einem UMDF-Treiber stammend gekennzeichnet.

Das UMDF 2-Äquivalent dieser Methode ist WdfRequestSetUserModeDriverInitiatedIo.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.11
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

GetUserModeDriverInitiatedIo

IWDFIoRequest3

WdfRequestSetUserModeDriverInitiatedIo