Compartilhar via

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

  • Artigo

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

Sintaxe

PFND3DKMT_ENUMADAPTERS2 Pfnd3dkmtEnumadapters2;

NTSTATUS Pfnd3dkmtEnumadapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
)
{...}

Parâmetros

unnamedParam1

_Inout_D3DKMT_ENUMADAPTERS2 * Arg1

O chamador passa o tamanho da matriz e o espaço vazio da matriz. O receptor de chamada verifica espaço suficiente na matriz, preenche a matriz e retorna o quanto da matriz foi usada.

Valor de retorno

Essa função retorna NTSTATUS.

Código de retorno Descrição
STATUS_BUFFER_TOO_SMALL Quando a matriz fornecida é muito pequena para receber todos os adaptadores.
STATUS_INVALID_PARAMETER Quando pEnumAdapters é nulo ou de outra forma é uma região de memória inválida.
STATUS_NO_MEMORY Quando a memória não pode ser alocada para satisfazer a operação.

Observações

Quando D3DKMT_ENUMADAPTERS2::p Adapters é nulo, D3DKMT_ENUMADAPTERS2::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 destinatário por meio de pEnumAdapters e devem ser fechados com D3DKMTCloseAdapter.

Requisitos

Requisito Valor
cabeçalho d3dkmthk.h

Consulte também