WdfRequestIsFrom32BitProcess, fonction (wdfrequest.h)

  • Article

[S’applique à KMDF et UMDF]

La méthode WdfRequestIsFrom32BitProcess vérifie si l’initiateur d’une demande d’E/S spécifiée est une application en mode utilisateur 32 bits.

Syntaxe

BOOLEAN WdfRequestIsFrom32BitProcess(
  [in] WDFREQUEST Request
);

Paramètres

[in] Request

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

Valeur retournée

Sur les systèmes 64 bits, WdfRequestIsFrom32BitProcess retourne TRUE si l’initiateur de la demande d’E/S actuelle est un processus en mode utilisateur 32 bits, et FALSE dans le cas contraire. Sur les systèmes 32 bits, WdfRequestIsFrom32BitProcess retourne toujours TRUE.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Les pilotes peuvent appeler WdfRequestIsFrom32BitProcess pour déterminer si une demande d’E/S est susceptible de contenir des éléments de données qui doivent être convertis, ou « thunked », avant de pouvoir être utilisés dans un pilote 64 bits.

Le handle de requête spécifié doit avoir été obtenu à partir de l’une des files d’attente d’E/S du pilote et non d’un appel à WdfRequestCreate.

Exemples

L’exemple de code suivant détermine si une demande d’E/S provient d’une application 32 bits.

VOID
MyEvtIoRead(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  Length
    )
{
...
    if (WdfRequestIsFrom32BitProcess(Request)) {
        //
        // The driver is running on a 64-bit computer and the 
        // I/O request came from a 32-bit application.
        //
...
    }
...
}

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête wdfrequest.h (include Wdf.h)
Bibliothèque Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfRequestCreate