Método IWDFObject::RetrieveContext (wudfddi.h)

[Advertencia: UMDF 2 es la versión más reciente de UMDF y reemplaza a UMDF 1. Todos los nuevos controladores UMDF deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores Windows universales deben usar UMDF 2. Para obtener más información, vea Tareas iniciales con UMDF).]

El método RetrieveContext recupera un contexto que se registró previamente a través del método IWDFObject::AssignContext .

Sintaxis

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

Parámetros

[out] ppvContext

Puntero a un búfer que recibe un puntero al contexto registrado previamente.

Valor devuelto

RetrieveContext devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.

Observaciones

Dado que el contexto no es una interfaz de Modelo de objetos componentes (COM), el controlador no debe tratar el contexto como tal. Por ejemplo, el controlador no puede llamar al método AddRef en el contexto.

Ejemplos

Para obtener un ejemplo de código de cómo usar el método RetrieveContext , vea IWDFIoQueue::GetDevice.

Requisitos

   
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.5
Encabezado wudfddi.h (incluir Wudfddi.h)
Archivo DLL WUDFx.dll

Vea también

IWDFIoQueue::GetDevice

IWDFObject

IWDFObject::AssignContext