Metodo IWDFIoRequest3::SetUserModeDriverInitiatedIo (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]
Metodo setUserModeDriverInitiatedIo
indica ai driver in modalità kernel che si trovano sotto il driver UMDF nello stesso stack di dispositivi che una determinata richiesta deve essere considerata come se provenisse da un driver UMDF.
Sintassi
void SetUserModeDriverInitiatedIo(
[in] BOOL IsUserModeDriverInitiated
);
Parametri
[in] IsUserModeDriverInitiated
Valore booleano che, se TRUE, indica che la richiesta deve essere considerata come se fosse stata avviata da un driver UMDF. Se FALSE, questo parametro indica che la richiesta deve essere considerata come se provenisse da un'applicazione.
Valore restituito
Nessuno
Osservazioni
Se un driver UMDF chiama questo metodo con il parametro IsUserModeDriverInitiated impostato su TRUE, il framework imposta il flag IRP_UM_DRIVER_INITIATED_IO nel Flags membro della struttura IRP WDM prima di inoltrare la richiesta ai driver in modalità kernel.
Un driver in modalità kernel che si trova sotto il driver UMDF nello stesso stack di dispositivi può verificare la presenza di questo flag per determinare se la richiesta deve essere considerata come se avviata da un driver UMDF.
Questo flag non è applicabile ai driver in modalità kernel che potrebbero ricevere una richiesta da un driver UMDF tramite una destinazione di I/O con handle di file o una destinazione I/O Win32.
Un driver UMDF potrebbe impostare il parametro IsUserModeDriverInitiated su TRUE per una richiesta proveniente da un'applicazione se il driver ha convalidato la richiesta.
Le richieste che il driver creato autonomamente sono già contrassegnate come originate da un driver UMDF.
L'equivalente di UMDF 2 di questo metodo è WdfRequestSetUserModeDriverInitiatedIo.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.11 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |