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 o quanto da matriz foi usada.
Valor de retorno
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. |
Observações
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 destinatário 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 Enumeração D3DKMTEnumAdapters2. 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.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 2004 |
| da Plataforma de Destino |
Windows |
| cabeçalho | d3dkmthk.h (inclua D3dkmthk.h) |
| biblioteca | onecoreuap.lib |
| de DLL |
Gdi32.dll |