WdfRequestSetUserModeDriverInitiatedIo, fonction (wdfrequest.h)
[S’applique uniquement à UMDF]
La méthode WdfRequestSetUserModeDriverInitiatedIo indique aux pilotes en mode noyau qui se trouvent sous le pilote UMDF dans la même pile de périphériques qu’une demande particulière doit être traitée comme si elle provient d’un pilote UMDF.
Syntaxe
void WdfRequestSetUserModeDriverInitiatedIo(
[in] WDFREQUEST Request,
[in] BOOLEAN IsUserModeDriverInitiated
);
Paramètres
[in] Request
Handle vers un objet de requête de framework.
[in] IsUserModeDriverInitiated
Valeur booléenne qui, si TRUE, indique que la requête doit être traitée comme si elle a été lancée par un pilote UMDF. Si FALSE, ce paramètre indique que la requête doit être traitée comme si elle provient d’une application.
Valeur de retour
Aucun
Remarques
Si un pilote UMDF appelle cette méthode avec le paramètre IsUserModeDriverInitiated défini sur TRUE, l’infrastructure définit l’indicateur IRP_UM_DRIVER_INITIATED_IO dans les indicateurs de membre de la structure WDM IRP avant de transférer la requête aux pilotes en mode noyau.
Un pilote en mode noyau qui se trouve sous le pilote UMDF dans la même pile d’appareils peut rechercher cet indicateur pour déterminer si la demande doit être traitée comme si elle doit être initiée par un pilote UMDF.
Cet indicateur n’est pas applicable aux pilotes en mode noyau qui peuvent recevoir une requête d’un pilote UMDF via une cible d’E/S de handle de fichier ou une cible d’E/S Win32.
Un pilote UMDF peut définir le paramètre IsUserModeDriverInitiated sur TRUE pour une demande provenant d’une application si le pilote a validé la requête.
Les demandes que le pilote créé par lui-même sont déjà marquées comme provenant d’un pilote UMDF.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8.1 |
| plateforme cible | Universel |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfrequest.h (include Wdf.h) |
| bibliothèque | WUDFx02000.lib ; WUDFx02000.dll |
| IRQL | PASSIVE_LEVEL |