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

Artículo
08/07/2023

La función DxgkDdiQueryChildStatus devuelve el estado de un dispositivo secundario individual de un adaptador de pantalla.

Sintaxis

DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;

NTSTATUS DxgkddiQueryChildStatus(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PDXGK_CHILD_STATUS ChildStatus,
  [in]      IN_BOOLEAN NonDestructiveOnly
)
{...}

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] ChildStatus

Puntero a una estructura DXGK_CHILD_STATUS . El autor de la llamada proporciona ChildStatus-Type> y ChildStatus-ChildUid>. A cambio, el miembro de estructura restante (una unión) recibe el estado solicitado.

[in] NonDestructiveOnly

Valor BOOLEAN que especifica si el controlador de minipuerto de pantalla puede determinar el estado solicitado de una manera que provoca artefactos visuales. Si el autor de la llamada establece este parámetro en TRUE, no se permite que el controlador de minipuerto de pantalla cause artefactos. Si el autor de la llamada establece este parámetro en FALSE, el controlador de minipuerto de pantalla puede provocar artefactos.

Valor devuelto

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

Comentarios

Durante la inicialización, el controlador de puerto de visualización llama a DxgkDdiQueryChildRelations para obtener una lista de dispositivos que son elementos secundarios del adaptador de pantalla representado por MiniportDeviceContext. A continuación, para cada elemento secundario que tenga un valor de reconocimiento de HPD de HpdAwarenessPolled o HpdAwarenessInterruptible, el controlador de puerto de visualización llama a DxgkDdiQueryChildStatus para determinar si el elemento secundario tiene actualmente hardware (por ejemplo, un monitor) conectado a él.

DxgkDdiQueryChildStatus debe realizar las siguientes acciones:

Si ChildStatus->Type es igual a StatusConnection, devuelve un valor booleano en ChildStatus->HotPlug.Connected. Devuelve TRUE si el dispositivo secundario identificado por ChildStatus->ChildUid tiene hardware externo conectado a él; de lo contrario, devuelve FALSE.
Si ChildStatus->Type es igual a StatusRotation, devuelve (en ChildStatus->Rotation.Angle) el ángulo de rotación de la pantalla conectada al dispositivo secundario identificado por ChildStatus->ChildUid.

DxgkDdiQueryChildStatus debe ser paginable.