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

Consulte también

DXGK_CHILD_CONTAINER_ID

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

DxgkDdiQueryDeviceDescriptor