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)

Voir aussi

WdfRequestCompleteWithInformation

WdfRequestSetInformation