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

Статья
02/06/2025

Функция DxgkDdiQueryChildStatus возвращает состояние отдельного дочернего устройства адаптера отображения.

Синтаксис

DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;

NTSTATUS DxgkddiQueryChildStatus(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PDXGK_CHILD_STATUS ChildStatus,
  [in]      IN_BOOLEAN NonDestructiveOnly
)
{...}

Параметры

[in] MiniportDeviceContext

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

[in, out] ChildStatus

Указатель на структуру DXGK_CHILD_STATUS. Вызывающий объект предоставляет ChildStatus->Type и ChildStatus->ChildUid. По возвращении оставшийся член структуры (профсоюз) получает запрошенное состояние.

[in] NonDestructiveOnly

Значение BOOLEAN, указывающее, разрешен ли драйвер мини-порта отображения определить запрошенное состояние таким образом, чтобы вызвать визуальные артефакты. Если вызывающий параметр задает значение TRUE, драйвер минипорта дисплея не может вызывать артефакты. Если вызывающий параметр задает значение false false, то драйвер мини-порта дисплея может вызвать артефакты.

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

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

Замечания

Во время инициализации драйвер порта отображения вызывает DxgkDdiQueryChildRelations, чтобы получить список устройств, которые являются дочерними адаптерами дисплея, представленными MiniportDeviceContext. Затем для каждого дочернего объекта, который имеет значение осведомленности HPD hpdAwarenessPolled или HpdAwarenessInterruptible, драйвер порта отображения вызывает DxgkDdiQueryChildStatus, чтобы определить, имеет ли ребенок оборудование (например, монитор).

DxgkDdiQueryChildStatus должны выполнять следующие действия:

Если Тип ChildStatus->равен StatusConnection, возвращает логическое значение в ChildStatus->HotPlug.Connected. Верните TRUE, если дочернее устройство, определенное ChildStatus->ChildUid, имеет к нему внешнее оборудование; в противном случае возвращает FALSE.
Если Тип ChildStatus->равен StatusRotation, возвращается (в ChildStatus->Поворот.Angle) угол поворота для отображения, подключенного к дочернему устройству, определяемого childStatus->ChildUid.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	dispmprt.h
IRQL	PASSIVE_LEVEL

См. также

DXGK_CHILD_STATUS

DXGK_CHILD_STATUS_TYPE

DxgkDdiQueryChildRelations

Поделиться через