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

Статья
02/23/2024

Запрашивает идентификатор контейнера для указанного целевого объекта. Реализовано в windows Display Driver Model (WDDM) 1.2 и более поздних версиях драйверов минипорта дисплея.

Синтаксис

DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;

NTSTATUS DxgkddiGetChildContainerId(
  [in]      PVOID MiniportDeviceContext,
  [in]      ULONG ChildUid,
  [in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}

Параметры

[in] MiniportDeviceContext

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

[in] ChildUid

Значение ULONG, однозначно идентифицирующее дочернее устройство. Драйвер мини-порта дисплея ранее предоставлял этот идентификатор при вызове функции DxgkDdiQueryChildRelations .

[in, out] ContainerId

Указатель на структуру DXGK_CHILD_CONTAINER_ID . Дополнительные сведения см. в разделе «Примечания».

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

Возвращает один из следующих кодов ошибок.

Код возврата	Описание
STATUS_SUCCESS	Драйвер обновил структуру, на которую указывает параметр ContainerId, с помощью сведений об идентификаторе контейнера, полученных от оборудования отображения.
STATUS_MONITOR_NODESCRIPTOR	Драйвер принял сведения об идентификаторе контейнера по умолчанию, указанные в структуре, на которую указывает ContainerId. Примечание: Если драйвер возвращает этот код состояния, он не должен изменять структуру.

В противном случае функция возвращает один из кодов состояния, определенных в Ntstatus.h.

Операционная система вызывает функцию DxgkDdiQueryChildRelations драйвера мини-порта дисплея для перечисления дочерних устройств видеоадаптера. Затем операционная система вызывает функцию DxgkDdiQueryDeviceDescriptor драйвера мини-порта дисплея для каждого дочернего устройства, чтобы получить EDID для устройства. Дополнительные сведения об этой процедуре см. в разделе Перечисление дочерних устройств видеоадаптера.

На основе данных EDID устройства операционная система создает идентификатор контейнера по умолчанию для дочернего устройства. Затем операционная система вызывает функцию DxgkDdiGetChildContainerId драйвера мини-порта дисплея и передает указатель на структуру DXGK_CHILD_CONTAINER_ID через параметр ContainerId . Элемент ContainerId этой структуры содержит идентификатор контейнера по умолчанию для дочернего устройства отображения.

Драйвер мини-порта дисплея может либо принять идентификатор контейнера по умолчанию, либо задать для элемента ContainerId уникальный идентификатор устройства, прежде чем он будет возвращен из вызова DxgkDdiGetChildContainerId.

Дополнительные сведения об идентификаторах контейнеров см. в разделе Идентификаторы контейнеров.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Персональный компьютер
Верхняя часть	dispmprt.h
IRQL	PASSIVE_LEVEL

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

DXGK_CHILD_CONTAINER_ID

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

DxgkDdiQueryDeviceDescriptor

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