DXGKDDI_QUERY_CHILD_RELATIONS função de retorno de chamada (dispmprt.h)
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 miniporto de exibição anteriormente forneceu esse identificador para o subsistema de kernel de elementos gráficos DirectX.
[in, out] ChildRelations
Um ponteiro para uma matriz de estruturas de DXGK_CHILD_DESCRIPTOR 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, do ChildRelations matriz, incluindo a estrutura zero no final.
Valor de retorno
DxgkDdiQueryChildRelations retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
Observações
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 de 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 em novas saídas de vídeo disponíveis, 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 disponibilizada por página.
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 |