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

Запрашивает идентификатор контейнера для указанного целевого объекта. Реализованная моделью драйвера windows (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

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

[in] ChildUid

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

[in, out] ContainerId

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

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

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

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

Замечания

Операционная система вызывает функцию драйвера минипорта для отображения dxgkDdiQueryChildRelations для перечисления дочерних устройств адаптера дисплея. Затем операционная система вызывает функцию драйвера минипорта для отображения dxgkDdiQueryDeviceDescriptor для каждого дочернего устройства, чтобы получить расширенные данные сведений о отображении (EDID) для устройства. Дополнительные сведения об этой процедуре см. в перечислении дочерних устройствадаптера отображения.

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

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

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

Требования

См. также

DXGK_CHILD_CONTAINER_ID

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

DxgkDdiQueryDeviceDescriptor