Compartilhar via

DXGKDDI_QUERY_CHILD_STATUS função de retorno de chamada (dispmprt.h)

  • Artigo

A função DxgkDdiQueryChildStatus retorna a 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 miniporta de exibição forneceu anteriormente 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 restante da estrutura (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 TRUE, 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.

Retornar valor

DxgkDdiQueryChildStatus retornará STATUS_SUCCESS se for bem-sucedido; caso contrário, retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

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. Retornará TRUE se o dispositivo filho identificado por ChildStatus->ChildUid tiver hardware externo conectado a ele; caso contrário, retornará FALSE.
  • Se ChildStatus->Type for igual a StatusRotation, retorne (em ChildStatus->Rotation.Angle) o ângulo de rotação para a tela conectada ao dispositivo filho identificado por ChildStatus->ChildUid.
DxgkDdiQueryChildStatus deve ser tornado paginável.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho dispmprt.h
IRQL PASSIVE_LEVEL

Confira também

DXGK_CHILD_STATUS

DXGK_CHILD_STATUS_TYPE

DxgkDdiQueryChildRelations