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

Artigo
05/23/2024

A função DxgkDdiQueryChildRelations enumera os dispositivos filho de um adaptador de exibição.

Sintaxe

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

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

Um ponteiro para uma matriz de DXGK_CHILD_DESCRIPTOR estruturas alocadas e zerados pelo chamador. O número de elementos na matriz é um maior que o valor retornado por DxgkDdiStartDevice no parâmetro NumberOfChildren . DxgkDdiQueryChildRelations deve preencher todas, exceto a última estrutura na matriz, com informações que descrevem os dispositivos filho do adaptador de exibição. A última estrutura na matriz deve permanecer zerado.

[in] ChildRelationsSize

O tamanho total, em bytes, da matriz ChildRelations , incluindo a estrutura zero no final.

Retornar valor

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

Comentários

Todos os dispositivos filho do adaptador de exibição estão integrados; monitores e outros dispositivos externos que se conectam ao adaptador de exibição não são considerados dispositivos filho.

O driver do miniporto de exibição deve preencher uma matriz de estruturas DXGK_CHILD_DESCRIPTOR, uma para cada um dos filhos do adaptador de exibição. A matriz deve conter estruturas DXGK_CHILD_DESCRIPTOR para todos os dispositivos filho atuais e todos os dispositivos filho em potencial. Por exemplo, se o encaixe de um computador portátil resultar na disponibilização de novas saídas de vídeo, essas saídas de vídeo deverão ter descritores na matriz, mesmo que não estejam disponíveis no momento.

A função DxgkDdiQueryChildRelations deve ser tornada paginável.