Partager via


WdfRequestWdmGetIrp, fonction (wdfrequest.h)

[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 vers un objet de requête de framework.

Valeur de retour

WdfRequestWdmGetIrp retourne un pointeur vers une structure de IRP.

Une vérification de bogue 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 demande après fin de la demande d’E/S.

Pour plus d’informations sur WdfRequestWdmGetIrp, consultez Obtenir des 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ée à une requête d’E/S, puis appelle IoGetNextIrpStackLocation pour obtenir l’emplacement de la pile d’E/S suivante du pilote inférieur.

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);
...
}

Exigences

Exigence Valeur
plateforme cible Universel
version minimale de KMDF 1.0
d’en-tête wdfrequest.h (include Wdf.h)
bibliothèque Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL <=DISPATCH_LEVEL
règles de conformité DDI DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfRequestGetParameters