Fonction WdfRequestWdmGetIrp (wdfrequest.h)

  • Article

[S’applique uniquement à KMDF]

La méthode WdfRequestWdmGetIrp retourne la structure IRP WDM associée à un objet de requête d’infrastructure spécifié.

Syntaxe

PIRP WdfRequestWdmGetIrp(
  [in] WDFREQUEST Request
);

Paramètres

[in] Request

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

Valeur retournée

WdfRequestWdmGetIrp retourne un pointeur vers une structure IRP .

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

Remarques

Le pilote ne doit pas accéder à la structure IRP d’une requête après avoir terminé la demande d’E/S.

Pour plus d’informations sur WdfRequestWdmGetIrp, consultez Obtention d’informations sur une demande d’E/S.

Exemples

L’exemple de code suivant fait partie d’une fonction de rappel EvtIoDeviceControl qui obtient l’IRP WDM associé à une demande d’E/S, puis appelle IoGetNextIrpStackLocation pour obtenir l’emplacement de pile d’E/S du pilote suivant.

VOID
MyEvtIoDeviceControl(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  OutputBufferLength,
    IN size_t  InputBufferLength,
    IN ULONG  IoControlCode
    )
{
    PIRP  irp = NULL;
    PIO_STACK_LOCATION  nextStack;
...
    irp = WdfRequestWdmGetIrp(Request);
    nextStack = IoGetNextIrpStackLocation(irp);
...
}

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfrequest.h (include Wdf.h)
Bibliothèque Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL <=DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfRequestGetParameters