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

  • Статья

Функция 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

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

[in, out] ChildStatus

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

[in] NonDestructiveOnly

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

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

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

Комментарии

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

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

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

Требования

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

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

DXGK_CHILD_STATUS

DXGK_CHILD_STATUS_TYPE

DxgkDdiQueryChildRelations