WdfRequestGetInformation, fonction (wdfrequest.h)
[S’applique à KMDF et UMDF]
La méthode WdfRequestGetInformation retourne l’achèvement status informations pour une demande d’E/S spécifiée.
Syntaxe
ULONG_PTR WdfRequestGetInformation(
[in] WDFREQUEST Request
);
Paramètres
[in] Request
Handle pour un objet de requête d’infrastructure.
Valeur retournée
WdfRequestGetInformation retourne les informations qu’un pilote de niveau inférieur a définies en appelant WdfRequestSetInformation ou WdfRequestCompleteWithInformation.
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Un pilote peut appeler WdfRequestSetInformation ou WdfRequestCompleteWithInformation pour définir l’achèvement status informations pour une demande d’E/S. Votre pilote peut appeler WdfRequestGetInformation après qu’un pilote de niveau inférieur a terminé une demande, pour obtenir l’achèvement status informations définies par le pilote de niveau inférieur.
Si votre pilote appelle WdfRequestGetInformation après avoir appelé WdfRequestComplete pour terminer la requête, WdfRequestGetInformation retourne NULL.
Pour plus d’informations sur WdfRequestGetInformation, consultez Achèvement des demandes d’E/S.
Exemples
L’exemple de code suivant envoie une demande d’E/S à une cible d’E/S, puis obtient status informations fournies par la cible d’E/S.
ULONG_PTR informationRetrieved = NULL;
status = WdfIoTargetSendWriteSynchronously(
ioTarget,
request,
&outputMemoryDescriptor,
NULL,
NULL,
&bytesWritten
);
if (NT_SUCCESS(status)) {
informationRetrieved = WdfRequestGetInformation(request);
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfrequest.h (inclure 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) |