DXGKDDI_QUERY_CHILD_RELATIONS función de devolución de llamada (dispmprt.h)

Artículo
05/23/2024

La función DxgkDdiQueryChildRelations enumera los dispositivos secundarios de un adaptador de pantalla.

Sintaxis

DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;

NTSTATUS DxgkddiQueryChildRelations(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] PDXGK_CHILD_DESCRIPTOR ChildRelations,
  [in]      ULONG ChildRelationsSize
)
{...}

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 DirectX.

[in, out] ChildRelations

Puntero a una matriz de DXGK_CHILD_DESCRIPTOR estructuras asignadas y a cero por el autor de la llamada. El número de elementos de la matriz es uno mayor que el valor devuelto por DxgkDdiStartDevice en el parámetro NumberOfChildren . DxgkDdiQueryChildRelations debe rellenar toda la estructura excepto la última estructura de la matriz con información que describa los dispositivos secundarios del adaptador de pantalla. La última estructura de la matriz debe permanecer en cero.

[in] ChildRelationsSize

Tamaño total, en bytes, de la matriz ChildRelations , incluida la estructura de ceros al final.

Valor devuelto

DxgkDdiQueryChildRelations devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Comentarios

Todos los dispositivos secundarios del adaptador de pantalla están incorporados; Los monitores y otros dispositivos externos que se conectan al adaptador de pantalla no se consideran dispositivos secundarios.

El controlador de minipuerto de pantalla debe rellenar una matriz de estructuras de DXGK_CHILD_DESCRIPTOR, una para cada uno de los elementos secundarios del adaptador de pantalla. La matriz debe contener estructuras DXGK_CHILD_DESCRIPTOR para todos los dispositivos secundarios actuales y todos los posibles dispositivos secundarios. Por ejemplo, si acoplar un equipo portátil hará que las nuevas salidas de vídeo estén disponibles, esas salidas de vídeo deben tener descriptores en la matriz, aunque no estén disponibles actualmente.

La función DxgkDdiQueryChildRelations debe ser paginable.