DXGKDDI_QUERY_CHILD_RELATIONS función de devolución de llamada (dispmprt.h)
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | dispmprt.h |
| IRQL | PASSIVE_LEVEL |