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

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos 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 universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método RetrieveContext recupera un contexto que se registró anteriormente 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 anteriormente.

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.

Comentarios

Dado que el contexto no es una interfaz del 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 sobre cómo usar el método RetrieveContext , vea IWDFIoQueue::GetDevice.

Requisitos

Requisito Value
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 (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFIoQueue::GetDevice

IWDFObject

IWDFObject::AssignContext