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

Статья
08/07/2023

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

Синтаксис

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

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

Параметры

HwDeviceExtension

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

Context

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

ValueName

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

ValueData

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

ValueLength

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

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

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

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

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

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

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

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

HwVidQueryNamedValueCallback следует сделать страничной.