Função D3DKMTEnumAdapters3 (d3dkmthk.h)

Fornece informações para enumerar elementos gráficos e adaptadores de exibição no sistema.

Sintaxe

NTSTATUS D3DKMTEnumAdapters3(
  [in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
);

Parâmetros

[in/out] unnamedParam1

Uma estrutura D3DKMT_ENUMADAPTERS3 . O chamador passa o tamanho da matriz e um espaço de matriz vazio. O receptor verifica se há espaço suficiente na matriz, preenche a matriz e retorna quanto da matriz foi usada.

Retornar valor

Essa função retorna NTSTATUS.

Código de retorno	Descrição
STATUS_BUFFER_TOO_SMALL	A matriz fornecida é muito pequena para receber todos os adaptadores.
STATUS_INVALID_PARAMETER	O membro pEnumAdapters é nulo 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.

Comentários

Quando D3DKMT_ENUMADAPTERS3::p Adapters é nulo, D3DKMT_ENUMADAPTERS3::NumAdapters é definido como a contagem máxima de adaptadores com suporte. Os callees normalmente invocarão o método , primeiro, para recuperar a contagem máxima de adaptadores com suporte.

Quando o receptor enumera adaptadores com êxito, ele se torna responsável por gerenciar explicitamente o tempo de vida do adaptador D3DKMT_HANDLEs. Esses identificadores são retornados ao receptor por meio de pEnumAdapters e devem ser fechados com D3DKMTCloseAdapter.

Definir nenhum dos sinalizadores D3DKMT_ENUMADAPTERS3::Filter ainda enumerará adaptadores, mas há menos adaptadores que D3DKMTEnumAdapters2 enumerados. Os adaptadores ComputeOnly são deixados de fora da enumeração padrão, para evitar a interrupção de aplicativos. Os adaptadores DisplayOnly também são deixados de fora da enumeração padrão.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 2004
Plataforma de Destino	Windows
Cabeçalho	d3dkmthk.h (inclua D3dkmthk.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll

Confira também

D3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter

PFND3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter