DXGKDDI_QUERY_CHILD_STATUS função de retorno de chamada (dispmprt.h)
A função DxgkDdiQueryChildStatus retorna o status de um dispositivo filho individual de um adaptador de exibição.
Sintaxe
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
Um identificador para um bloco de contexto associado a um adaptador de exibição. A função DxgkDdiAddDevice do driver de miniporto de exibição anteriormente forneceu esse identificador para o subsistema de kernel de elementos gráficos DirectX.
[in, out] ChildStatus
Um ponteiro para uma estrutura DXGK_CHILD_STATUS. O chamador fornece ChildStatus->Type e ChildStatus->ChildUid. No retorno, o membro da estrutura restante (um sindicato) recebe o status solicitado.
[in] NonDestructiveOnly
Um valor BOOLEAN que especifica se o driver de miniporto de exibição tem permissão para determinar o status solicitado de uma maneira que cause artefatos visuais. Se o chamador definir esse parâmetro como VERDADEIRO, o driver de miniporto de exibição não poderá causar artefatos. Se o chamador definir esse parâmetro como FALSE, o driver de miniporto de exibição poderá causar artefatos.
Valor de retorno
DxgkDdiQueryChildStatus retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
Observações
Durante a inicialização, o driver de porta de exibição chama DxgkDdiQueryChildRelations para obter uma lista de dispositivos que são filhos do adaptador de exibição representado por MiniportDeviceContext. Em seguida, para cada filho que tem um valor de reconhecimento hpd de hpdAwarenessPolled ou hpdAwarenessInterruptible, o driver de porta de exibição chama DxgkDdiQueryChildStatus para determinar se o filho atualmente tem hardware (por exemplo, um monitor) conectado a ele.
DxgkDdiQueryChildStatus deve executar as seguintes ações:
- Se ChildStatus->Type for igual a StatusConnection, retorne um valor booliano em ChildStatus->HotPlug.Connected. Retorne VERDADEIRO se o dispositivo filho identificado pelo ChildStatus->ChildUid tiver hardware externo conectado a ele; caso contrário, retorne FALSE .
- Se ChildStatus->Type for igual a StatusRotation, retorne (em ChildStatus->Rotation.Angle) o ângulo de rotação para a exibição conectada ao dispositivo filho identificado pelo ChildStatus->ChildUid.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h |
| IRQL | PASSIVE_LEVEL |