Поделиться через


Метод IWDFObject::RetrieveContext (wudfddi.h)

[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]

Метод RetrieveContext извлекает контекст, который ранее был зарегистрирован с помощью метода IWDFObject::AssignContext.

Синтаксис

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

Параметры

[out] ppvContext

Указатель на буфер, получающий указатель на ранее зарегистрированный контекст.

Возвращаемое значение

RetrieveContext возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Замечания

Так как контекст не является интерфейсом COM-модели компонента, драйвер не должен рассматривать контекст как таковой. Например, драйвер не может вызвать метод AddRef в контексте.

Примеры

Пример кода использования метода RetrieveContext см. в разделе IWDFIoQueue::GetDevice.

Требования

Требование Ценность
завершение поддержки Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа Настольный
минимальная версия UMDF 1.5
заголовка wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

См. также

IWDFIoQueue::GetDevice

IWDFObject

IWDFObject::AssignContext