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

  • Artículo

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.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado dispmprt.h
IRQL PASSIVE_LEVEL

Consulte también

DXGK_CHILD_STATUS

DXGK_CHILD_STATUS_TYPE

DxgkDdiQueryChildRelations