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. Non vengono aggiunte nuove funzionalità 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, vedi Introduzione a UMDF.]
Il metodo RetrieveContext recupera un contesto registrato in precedenza 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.
Osservazioni
Poiché il contesto non è un'interfaccia COM (Component Object Model), il driver non deve trattare il contesto come tale. Ad esempio, il driver non può chiamare il metodo AddRef nel contesto.
Esempi
Per un esempio di codice su come usare il metodo RetrieveContext, vedere IWDFIoQueue::GetDevice.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.5 |
| intestazione | wudfddi.h (include Wudfddi.h) |
| dll | WUDFx.dll |