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

  • Статья

Функция DxgkDdiQueryChildRelations перечисляет дочерние устройства видеоадаптера.

Синтаксис

DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;

NTSTATUS DxgkddiQueryChildRelations(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] PDXGK_CHILD_DESCRIPTOR ChildRelations,
  [in]      ULONG ChildRelationsSize
)
{...}

Параметры

[in] MiniportDeviceContext

Дескриптор для блока контекста, связанного с видеоадаптером. Функция DxgkDdiAddDevice драйвера мини-порта дисплея ранее предоставляла этот дескриптор подсистеме графического ядра DirectX.

[in, out] ChildRelations

Указатель на массив DXGK_CHILD_DESCRIPTOR структур, выделенных и обнуляемых вызывающим объектом. Число элементов в массиве на один больше значения, возвращаемого DxgkDdiStartDevice в параметре NumberOfChildren . DxgkDdiQueryChildRelations должен заполнить всю структуру, кроме последней, в массиве сведениями, описывающими дочерние устройства видеоадаптера. Последняя структура в массиве должна оставаться обнуляемой.

[in] ChildRelationsSize

Общий размер массива ChildRelations в байтах , включая обнуляемую структуру в конце.

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

DxgkDdiQueryChildRelations возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.

Комментарии

Все дочерние устройства видеоадаптера подключены; мониторы и другие внешние устройства, подключающиеся к адаптеру дисплея, не считаются дочерними устройствами.

Драйвер мини-порта дисплея должен заполнить массив DXGK_CHILD_DESCRIPTOR структур, по одной для каждого дочернего адаптера дисплея. Массив должен содержать DXGK_CHILD_DESCRIPTOR структуры для всех текущих дочерних устройств и всех потенциальных дочерних устройств. Например, если закрепление портативного компьютера приведет к тому, что новые видеовыходы станут доступными, эти видеовыходы должны иметь дескрипторы в массиве, даже если они в настоящее время недоступны.

Функция DxgkDdiQueryChildRelations должна быть выгружаема.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть dispmprt.h
IRQL PASSIVE_LEVEL

См. также раздел

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus

DxgkDdiQueryDeviceDescriptor