функция обратного вызова 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

Дескриптор для блока контекста, связанного с видеоадаптером. Функция DxgkDdiAdddDevice драйвера мини-порта дисплея ранее предоставляла этот дескриптор подсистеме ядра графики 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 следует сделать страничной.

Требования

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

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus

DxgkDdiQueryDeviceDescriptor