WdfRequestGetCompletionParams, fonction (wdfrequest.h)
[S’applique à KMDF et UMDF]
La méthode WdfRequestGetCompletionParams récupère les paramètres d’achèvement d’E/S associés à un objet de requête de framework spécifié.
Syntaxe
void WdfRequestGetCompletionParams(
[in] WDFREQUEST Request,
[in, out] PWDF_REQUEST_COMPLETION_PARAMS Params
);
Paramètres
[in] Request
Handle vers un objet de requête de framework.
[in, out] Params
Pointeur vers une structure de WDF_REQUEST_COMPLETION_PARAMS fournie par l’appelant.
Valeur de retour
Aucun
Remarques
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
Une fois qu’un pilote a appelé WdfRequestSend pour envoyer de manière synchrone ou asynchrone une requête d’E/S à une cible d’E/S, et une fois que la cible d’E/S a terminée la requête d’E/S, le pilote peut appeler WdfRequestGetCompletionParams pour obtenir les paramètres d’achèvement de la requête d’E/S.
La structure des paramètres d’achèvement contient des informations valides uniquement si le pilote a mis en forme la requête en appelant l’une des méthodes WdfIoTargetFormat WdfIoTargetFormatXxx. Par exemple, consultez WdfIoTargetFormatRequestForRead.
Notez que si votre pilote appelle l’une des méthodes qui envoient des requêtes d’E/S à des cibles d’E/S uniquement synchrones (par exemple, WdfIoTargetSendReadSynchronously), le pilote doit pas appeler WdfRequestGetCompletionParams.
La méthode WdfRequestGetCompletionParams copie les paramètres d’achèvement de la requête d’E/S dans la structure WDF_REQUEST_COMPLETION_PARAMS spécifiée.
Si un pilote envoie une requête d’E/S de façon asynchrone, il appelle généralement cette méthode à partir d’un CompletionRoutine fonction de rappel.
Pour plus d’informations sur WdfRequestGetCompletionParams, consultez Fin des requêtes d’E/S.
Exemples
L’exemple de code suivant initialise une structure WDF_REQUEST_COMPLETION_PARAMS, puis appelle WdfRequestGetCompletionParams.
WDF_REQUEST_COMPLETION_PARAMS completionParams;
WDF_REQUEST_COMPLETION_PARAMS_INIT(&completionParams);
WdfRequestGetCompletionParams(
request,
&completionParams
);
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfrequest.h (include 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) |