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. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con UMDF.]

Metodo SetUserModeDriverInitiatedIo

indica ai driver in modalità kernel che si trovano sotto il driver UMDF nello stesso stack di dispositivi che una richiesta specifica deve essere considerata come se proviene 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 avviata da un driver UMDF. Se FALSE, questo parametro indica che la richiesta deve essere considerata come se proviene 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 membro Flag della struttura IRP WDM prima di inoltrare la richiesta ai driver in modalità kernel.

Un driver in modalità kernel che risiede 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 I/O di gestione file o una destinazione di 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 per conto proprio sono già contrassegnate come originati da un driver UMDF.

L'equivalente UMDF 2 di questo metodo è WdfRequestSetUserModeDriverInitiatedIo.

Requisiti

Vedi anche

GetUserModeDriverInitiatedIo

IWDFIoRequest3

WdfRequestSetUserModeDriverInitiatedIo