WdfRequestSetUserModeDriverInitiatedIo-Funktion (wdfrequest.h)
[Gilt nur für UMDF]
Die WdfRequestSetUserModeDriverInitiatedIo Methode gibt an, dass Kernelmodustreiber, die sich unterhalb des UMDF-Treibers im selben Gerätestapel befinden, als ob eine bestimmte Anforderung von einem UMDF-Treiber behandelt werden sollte.
Syntax
void WdfRequestSetUserModeDriverInitiatedIo(
[in] WDFREQUEST Request,
[in] BOOLEAN IsUserModeDriverInitiated
);
Parameter
[in] Request
Ein Handle zu einem Framework-Anforderungsobjekt.
[in] IsUserModeDriverInitiated
Ein boolescher Wert, der, wenn TRUE, angibt, dass die Anforderung so behandelt werden soll, als ob sie von einem UMDF-Treiber initiiert wurde. Wenn FALSE, gibt dieser Parameter an, dass die Anforderung so behandelt werden soll, als ob sie aus einer Anwendung stammt.
Rückgabewert
Nichts
Bemerkungen
Wenn ein UMDF-Treiber diese Methode mit dem IsUserModeDriverInitiated Parameter aufruft, der auf TRUEfestgelegt ist, legt das Framework das IRP_UM_DRIVER_INITIATED_IO Flag im Flags Mitglied 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 auf dieses Flag überprüfen, um festzustellen, ob die Anforderung behandelt werden soll, als ob die Anforderung von einem UMDF-Treiber initiiert 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 erhalten.
Ein UMDF-Treiber legt möglicherweise den IsUserModeDriverInitiated Parameter auf TRUE- für eine Anforderung fest, die von einer Anwendung stammt, wenn der Treiber die Anforderung überprüft hat.
Anforderungen, die der von ihm erstellte Treiber selbst erstellt hat, sind bereits als von einem UMDF-Treiber gekennzeichnet.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1 |
| Zielplattform- | Universal |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfrequest.h (include Wdf.h) |
| Library | WUDFx02000.lib; WUDFx02000.dll |
| IRQL- | PASSIVE_LEVEL |