IWDFIoRequest ::SetCompletionCallback, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode SetCompletionCallback inscrit l’interface de la méthode OnCompletion que l’infrastructure doit appeler lorsqu’une requête d’E/S est terminée.
Syntaxe
void SetCompletionCallback(
[in] IRequestCallbackRequestCompletion *pCompletionCallback,
[in, optional] void *pContext
);
Paramètres
[in] pCompletionCallback
Pointeur vers l’interface IRequestCallbackRequestCompletion dont méthode OnCompletion l’infrastructure appelle une fois la requête d’E/S terminée. À compter de la version 1.9 de UMDF, le pilote peut spécifier NULL pour désinscrire 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 à la saisie semi-automatique de la demande. Le framework 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
Aucun
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, le pilote 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.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |
Voir aussi
IRequestCallbackRequestCompletion