IWDFObject ::RetrieveContext, méthode (wudfddi.h)

  • Article

[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 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 retournée

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.

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

Voir aussi

IWDFIoQueue ::GetDevice

IWDFObject

IWDFObject ::AssignContext