Méthode IWDFIoRequest3 ::SetUserModeDriverInitiatedIo (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]
Méthode SetUserModeDriverInitiatedIo
indique aux pilotes en mode noyau qui se trouvent sous le pilote UMDF dans la même pile de périphériques qu’une requête particulière doit être traitée comme si elle provenait d’un pilote UMDF.
Syntaxe
void SetUserModeDriverInitiatedIo(
[in] BOOL IsUserModeDriverInitiated
);
Paramètres
[in] IsUserModeDriverInitiated
Valeur booléenne qui, si true, indique que la demande doit être traitée comme si elle avait été initiée par un pilote UMDF. Si la valeur est FALSE, ce paramètre indique que la demande doit être traitée comme si elle provenait d’une application.
Valeur de retour
None
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 le membre Flags de la structure IRP WDM avant de transférer la demande aux pilotes en mode noyau.
Un pilote en mode noyau qui réside sous le pilote UMDF dans la même pile de périphériques peut case activée pour cet indicateur afin de déterminer si la demande doit être traitée comme si initiée par un pilote UMDF.
Cet indicateur ne s’applique pas aux pilotes en mode noyau qui peuvent recevoir une requête d’un pilote UMDF via une cible d’E/S à handle de fichiers ou une cible d’E/S Win32.
Un pilote UMDF peut définir le paramètre IsUserModeDriverInitiated sur TRUE pour une requête provenant d’une application si le pilote a validé la demande.
Les demandes que le pilote a créées seul sont déjà marquées comme provenant d’un pilote UMDF.
L’équivalent UMDF 2 de cette méthode est WdfRequestSetUserModeDriverInitiatedIo.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge | Non disponible dans UMDF 2.0 et versions ultérieures. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| Version UMDF minimale | 1.11 |
| En-tête | wudfddi.h (inclure Wudfddi.h) |
| DLL | WUDFx.dll |