Metodo IWDFObject::RetrieveContext (wudfddi.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]

Il metodo RetrieveContext recupera un contesto precedentemente registrato tramite il metodo IWDFObject::AssignContext .

Sintassi

HRESULT RetrieveContext(
  [out] void **ppvContext
);

Parametri

[out] ppvContext

Puntatore a un buffer che riceve un puntatore al contesto registrato in precedenza.

Valore restituito

RetrieveContext restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.

Commenti

Poiché il contesto non è un'interfaccia COM (Component Object Model), il driver non deve considerare il contesto come tale. Ad esempio, il driver non può chiamare il metodo AddRef nel contesto.

Esempio

Per un esempio di codice di come usare il metodo RetrieveContext , vedere IWDFIoQueue::GetDevice.

Requisiti

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1.5
Intestazione wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Vedi anche

IWDFIoQueue::GetDevice

IWDFObject

IWDFObject::AssignContext