IWDFObject ::RetrieveContext, 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 RetrieveContext récupère un contexte précédemment inscrit via la méthode IWDFObject ::AssignContext.
Syntaxe
HRESULT RetrieveContext(
[out] void **ppvContext
);
Paramètres
[out] ppvContext
Pointeur vers une mémoire tampon qui reçoit un pointeur vers le contexte précédemment inscrit.
Valeur de retour
RetrieveContext retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.
Remarques
Étant donné que le contexte n’est pas une interface COM (Component Object Model), le pilote ne doit pas traiter le contexte comme tel. Par exemple, le pilote ne peut pas appeler la méthode AddRef sur le contexte.
Exemples
Pour obtenir un exemple de code montrant comment utiliser la méthode RetrieveContext, consultez IWDFIoQueue ::GetDevice.
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 |