Fonction WdfRequestWdmGetIrp (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 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) |