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

Confira também

DXGK_CHILD_CONTAINER_ID

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

DxgkDdiQueryDeviceDescriptor