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 requête particulière doit être traitée comme si elle provenait d’un pilote UMDF.

Syntaxe

void WdfRequestSetUserModeDriverInitiatedIo(
  [in] WDFREQUEST Request,
  [in] BOOLEAN    IsUserModeDriverInitiated
);

Paramètres

[in] Request

Handle d’un objet de requête d’infrastructure.

[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.

Configuration requise

Voir aussi

WdfRequestGetUserModeDriverInitiatedIo