функция обратного вызова DXGKDDI_GET_CHILD_CONTAINER_ID (dispmprt.h)
Запрашивает идентификатор контейнера для указанного целевого объекта. Реализовано в 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 |