Compartilhar via

Função D3DKMTEnumAdapters2 (d3dkmthk.h)

  • Artigo

A função D3DKMTEnumAdapters2 fornece informações para enumerar todos os elementos gráficos e adaptadores de exibição no sistema.

Sintaxe

NTSTATUS D3DKMTEnumAdapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);

Parâmetros

unnamedParam1

[dentro, fora] Ponteiro para uma estrutura D3DKMT_ENUMADAPTERS2 na qual fornecer informações sobre adaptadores no sistema. Consulte Comentários.

Valor de retorno

D3DKMTEnumAdapters2 retorna STATUS_SUCCESS após o êxito ou um erro como um dos seguintes.

Código de retorno Descrição
STATUS_BUFFER_TOO_SMALL A matriz fornecida é muito pequena para receber todos os adaptadores.
STATUS_INVALID_PARAMETER pAdapters é NULL ou, caso contrário, é uma região de memória inválida.
STATUS_NO_MEMORY A memória não pode ser alocada para atender à operação.

Observações

Na entrada, NumAdapters especifica quantos adaptadores podem ser retornados na matriz vazia à qual pAdapters aponta. No retorno, se D3DKMT_ENUMADAPTERS2 retornar STATUS_SUCCESS:

  • Se pAdapters não for NULL, NumAdapters conterá o número de adaptadores retornados na matriz pAdapters .
  • Se pAdapters for NULL, NumAdapters conterá a contagem máxima de adaptadores com suporte.

Se D3DKMT_ENUMADAPTERS2 retornar um erro, NumAdapters será indefinido.

D3DKMTEnumAdapters2 normalmente é chamado duas vezes:

  • Para a primeira chamada, defina pAdapters como NULL. D3DKMTEnumAdapters2 gravará a contagem máxima de adaptadores com suporte em NumAdapters.

  • Para a segunda chamada, defina NumAdapters para o valor retornado na primeira chamada e defina pAdapters para apontar para uma matriz de estruturasD3DKMT_ENUMADAPTERS2 numAdapters . D3DKMTEnumAdapters2 preencherá a matriz e passará o número de estruturas de matriz (adaptadores) que ela preencheu.

Depois que o chamador de D3DKMTEnumAdapters2 tiver recebido com êxito uma enumeração dos adaptadores, é responsabilidade do chamador gerenciar o tempo de vida do adaptador D3DKMT_HANDLEs. Esses identificadores são retornados por pAdapters e devem ser fechados com D3DKMTCloseAdapter.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8
servidor com suporte mínimo Windows Server 2012
da Plataforma de Destino Windows
cabeçalho d3dkmthk.h (inclua D3dkmthk.h)
biblioteca Gdi32.lib
de DLL Gdi32.dll

Consulte também

D3DKMT_ENUMADAPTERS2

PFND3DKMT_ENUMADAPTERS2

D3DKMTCloseAdapter