Метод 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 (включая Wudfddi.h) |
DLL | WUDFx.dll |