PFND3DKMT_ENUMADAPTERS3 função de retorno de chamada (d3dkmthk.h)

Artigo
02/23/2024

A função de retorno de chamada PFND3DKMT_ENUMADAPTERS3 enumera os adaptadores gráficos e de exibição no sistema.

Sintaxe

PFND3DKMT_ENUMADAPTERS3 Pfnd3dkmtEnumadapters3;

NTSTATUS Pfnd3dkmtEnumadapters3(
  [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, de outra forma, é 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 invocam 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.

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