DXGKDDI_GET_CHILD_CONTAINER_ID função de retorno de chamada (dispmprt.h)
Consulta a ID do contêiner para o destino especificado. Implementado pelo WDDM (Modelo de Driver de Exibição do Windows) 1.2 e posterior exibe drivers de miniporto.
Sintaxe
DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;
NTSTATUS DxgkddiGetChildContainerId(
[in] PVOID MiniportDeviceContext,
[in] ULONG ChildUid,
[in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}
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 do Microsoft DirectX.
[in] ChildUid
Um valor ULONG que identifica exclusivamente o dispositivo filho. O driver de miniporto de exibição forneceu anteriormente esse identificador quando sua função DxgkDdiQueryChildRelations foi chamada.
[in, out] ContainerId
Um ponteiro para uma estrutura DXGK_CHILD_CONTAINER_ID. Para obter mais informações, consulte a seção Comentários.
Valor de retorno
Retorna um dos seguintes códigos de erro.
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | O driver atualizou a estrutura apontada pelo parâmetro ContainerId com informações de ID de contêiner obtidas do hardware de exibição. |
| STATUS_MONITOR_NODESCRIPTOR | O driver aceitou as informações de ID de contêiner padrão fornecidas na estrutura apontada por ContainerId. Observação: Se o driver retornar esse código de status, ele não deverá modificar a estrutura. |
Caso contrário, a função retornará um dos códigos de status definidos em Ntstatus.h.
Observações
O sistema operacional chama a função DxgkDdiQueryChildRelations do driver de miniporto de exibição para enumerar os dispositivos filho do adaptador de exibição. Em seguida, o sistema operacional chama a função DxgkDdiQueryDeviceDescriptor do driver de exibição para cada dispositivo filho para obter o EDID (Dados de Informações de Exibição Estendida) para o dispositivo. Para obter mais informações sobre este procedimento, consulte Enumerando dispositivos filho de um adaptador de exibição.
Com base nos dados EDID do dispositivo, o sistema operacional gera uma ID de contêiner padrão para o dispositivo filho. Em seguida, o sistema operacional chama a função DxgkDdiGetChildContainerId do driver de exibição e passa um ponteiro para uma estrutura DXGK_CHILD_CONTAINER_ID por meio do parâmetro ContainerId. O ContainerId membro dessa estrutura contém a ID de contêiner padrão para o dispositivo de exibição filho.
O driver de miniporto de exibição pode aceitar a ID de contêiner padrão ou definir o membro ContainerId como um identificador exclusivo para o dispositivo antes que ele retorne da chamada para DxgkDdiGetChildContainerId.
Para obter mais informações sobre IDs de contêiner, consulte IDs de contêiner.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| servidor com suporte mínimo | Windows Server 2012 |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h |
| IRQL | PASSIVE_LEVEL |