функция обратного вызова PMINIPORT_GET_REGISTRY_ROUTINE (video.h)

Статья
02/07/2025

HwVidQueryNamedValueCallback обрабатывает указанные данные, полученные из реестра.

Синтаксис

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

VP_STATUS PminiportGetRegistryRoutine(
  PVOID HwDeviceExtension,
  PVOID Context,
  PWSTR ValueName,
  PVOID ValueData,
  ULONG ValueLength
)
{...}

Параметры

HwDeviceExtension

Указатель на область хранения минипорта для каждого адаптера. Дополнительные сведения см. в расширениях устройств.

Context

Указатель на определяемый драйвером контекст, указанный в качестве входных данных функции VideoPortGetRegistryParameter s.

ValueName

Указатель на строку Юникода, завершающую значение NULL, именуя запись.

ValueData

Указатель на буферные данные, связанные с ValueName, предоставляемые VideoPortGetRegistryParameters.

ValueLength

Задает размер буфера в байтах в ValueData.

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

HwVidQueryNamedValueCallback возвращает состояние операции.

Замечания

HwVidQueryNamedValueCallback является необязательной функцией драйвера минипорта, переданной в вызове VideoPortGetRegistryParameters.

VideoPortGetRegistryParameters вызывает вызовы HwVidQueryNamedValueCallback после сбора доступных сведений о конфигурации указанного ValueName в адаптере раздела реестра.

HwVidFindAdapter или HwVidInitialize может вызывать VideoPortGetRegistryParameters с функцией HwVidQueryNamedValueCallback, указатели на расширение устройства и любые данные контекста, предоставленные драйвером (которые могут быть буфером VIDEO_PORT_CONFIG_INFO), а также указатель на строку Юникода, именующую значение, полученное из реестра.

HwVidFindAdapter или HwVidInitialize может задать VideoPortGetRegistryParametersаргумент IsFileNameParameter, чтобы TRUE, если строка Юникода указана драйвером, является именованной записью реестра, значение которой является именем файла. Для этой спецификации возвращенные данные будут содержимое именованного файла.

Когда VideoPortGetRegistryParameters вызывает функцию HwVidQueryNamedValueCallback, она обрабатывает все доступные данные конфигурации. Например, HwVidQueryNamedValueCallback могут использовать полученные данные для определения диапазонов доступа драйвера минипорта и настройки диапазонов доступа эмулятора (если таковые), вектор прерывания или прерывания IRQL (если таковые есть), а также т. д. в буфере VIDEO_PORT_CONFIG_INFO, а также в расширении устройства мини-порта, прежде чем возвращать управление функции HwVidFindAdapter.

HwVidInitialize также может вызывать VideoPortGetRegistryParameters с IsFileNameParameter TRUE, чтобы функция HwVidQueryNamedValueCallback могла использовать буферизованное содержимое именованного файла для настройки микрокода на адаптере.

Возвращенная ValueData находится в стеке, поэтому ее можно ссылать локально. HwVidQueryNamedValueCallback может хранить некоторые или все возвращаемые сведения для использования другими функциями драйвера мини-порта в входных HwDeviceExtension или использовать входные Контекст в качестве указателя на расположение, в котором можно хранить данные.

HwVidQueryNamedValueCallback должен быть доступен для страницы.