DXGKDDI_GET_CHILD_CONTAINER_ID función de devolución de llamada (dispmprt.h)
Consulta el identificador de contenedor para el destino especificado. Implementado por windows Display Driver Model (WDDM) 1.2 y posteriores controladores de miniporte de pantalla.
Sintaxis
DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;
NTSTATUS DxgkddiGetChildContainerId(
[in] PVOID MiniportDeviceContext,
[in] ULONG ChildUid,
[in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}
Parámetros
[in] MiniportDeviceContext
Identificador de un bloque de contexto asociado a un adaptador de pantalla. La función DxgkDdiAddDevice del controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de Microsoft DirectX.
[in] ChildUid
Valor de ULONG que identifica de forma única el dispositivo secundario. El controlador de minipuerto de pantalla proporcionó anteriormente este identificador cuando se llamó a su función DxgkDdiQueryChildRelations .
[in, out] ContainerId
Puntero a una estructura DXGK_CHILD_CONTAINER_ID . Para obtener más información, vea la sección Comentarios.
Valor devuelto
Devuelve uno de los siguientes códigos de error.
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | El controlador ha actualizado la estructura a la que apunta el parámetro ContainerId con información de identificador de contenedor obtenida del hardware de visualización. |
| STATUS_MONITOR_NODESCRIPTOR | El controlador ha aceptado la información de identificador de contenedor predeterminada proporcionada en la estructura a la que apunta ContainerId. Nota: Si el controlador devuelve este código de estado, no debe modificar la estructura. |
De lo contrario, la función devuelve uno de los códigos de estado definidos en Ntstatus.h.
Comentarios
El sistema operativo llama a la función DxgkDdiQueryChildRelations del controlador de miniporte de pantalla para enumerar los dispositivos secundarios del adaptador de pantalla. A continuación, el sistema operativo llama a la función DxgkDdiQueryDeviceDescriptor del controlador de miniporte de pantalla para cada dispositivo secundario para obtener los datos de información de visualización extendida (EDID) del dispositivo. Para obtener más información sobre este procedimiento, vea Enumerar dispositivos secundarios de un adaptador de pantalla.
En función de los datos EDID del dispositivo, el sistema operativo genera un identificador de contenedor predeterminado para el dispositivo secundario. A continuación, el sistema operativo llama a la función DxgkDdiGetChildContainerId del controlador de miniporte de pantalla y pasa un puntero a una estructura de DXGK_CHILD_CONTAINER_ID a través del parámetro ContainerId . El miembro ContainerId de esta estructura contiene el identificador de contenedor predeterminado para el dispositivo de visualización secundario.
El controlador de minipuerto de pantalla puede aceptar el identificador de contenedor predeterminado o establecer el miembro ContainerId en un identificador único para el dispositivo antes de que vuelva de la llamada a DxgkDdiGetChildContainerId.
Para obtener más información sobre los identificadores de contenedor, consulte Identificadores de contenedor.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Escritorio |
| Encabezado | dispmprt.h |
| IRQL | PASSIVE_LEVEL |