Méthode IWDFIoRequest ::SetCompletionCallback (wudfddi.h)

Article
03/01/2024

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode SetCompletionCallback inscrit l’interface de la méthode OnCompletion que l’infrastructure doit appeler lorsqu’une demande d’E/S se termine.

Syntaxe

void SetCompletionCallback(
  [in]           IRequestCallbackRequestCompletion *pCompletionCallback,
  [in, optional] void                              *pContext
);

Paramètres

[in] pCompletionCallback

Pointeur vers l’interface IRequestCallbackRequestCompletion dont l’infrastructure appelle la méthode OnCompletion une fois la demande d’E/S terminée. À compter de la version 1.9 d’UMDF, le pilote peut spécifier NULL pour annuler l’inscription d’une méthode OnCompletion précédemment inscrite.

[in, optional] pContext

Pointeur vers une mémoire tampon qui contient des informations de contexte liées à l’achèvement de la demande. L’infrastructure transmet ces informations de contexte dans un appel à la méthode IRequestCallbackRequestCompletion ::OnCompletion . Ce paramètre est facultatif et peut être NULL.

Valeur de retour

None

Remarques

Si un pilote qui transfère une demande d’E/S nécessite une notification lorsque le pilote de niveau inférieur termine la demande, il peut fournir une routine d’achèvement et appeler SetCompletionCallback pour inscrire l’interface IRequestCallbackRequestCompletion pour la routine d’achèvement . L’infrastructure appelle la routine d’achèvement une fois que le pilote de niveau inférieur a terminé la demande d’E/S.

Exemples

Pour obtenir un exemple de code montrant comment utiliser la méthode SetCompletionCallback , consultez IWDFIoRequest ::Send.

Configuration requise

Condition requise	Valeur
Fin de la prise en charge	Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
Version UMDF minimale	1.5
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll