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 Modelo de Driver de Vídeo do Windows (WDDM) 1.2 e posterior exibe drivers de miniporta.
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 miniporta de vídeo forneceu anteriormente 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.
Retornar valor
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. Nota: Se o driver retornar esse código status, ele não deverá modificar a estrutura. |
Caso contrário, a função retornará um dos códigos status definidos em Ntstatus.h.
Comentários
O sistema operacional chama a função DxgkDdiQueryChildRelations do driver de miniporta de exibição para enumerar os dispositivos filho do adaptador de vídeo. Em seguida, o sistema operacional chama a função DxgkDdiQueryDeviceDescriptor do driver de miniporta de exibição para cada dispositivo filho para obter os EDID (Dados de Informações de Exibição Estendidas) do dispositivo. Para obter mais informações sobre esse procedimento, consulte Enumerando dispositivos filho de um adaptador de vídeo.
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 miniporta de exibição e passa um ponteiro para uma estrutura DXGK_CHILD_CONTAINER_ID por meio do parâmetro ContainerId . O membro ContainerId 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 de retornar da chamada para DxgkDdiGetChildContainerId.
Para obter mais informações sobre IDs de contêiner, consulte IDs de contêiner.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | dispmprt.h |
| IRQL | PASSIVE_LEVEL |