функция обратного вызова 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 следует сделать страничной.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | dispmprt.h |
| IRQL | PASSIVE_LEVEL |