PFND3DKMT_ENUMADAPTERS3 função de retorno de chamada (d3dkmthk.h)
A função de retorno de chamada PFND3DKMT_ENUMADAPTERS3 enumera elementos gráficos e adaptadores 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 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 pEnumAdapterse devem ser fechados com D3DKMTCloseAdapter.
A definição de nenhum dos sinalizadores D3DKMT_ENUMADAPTERS3::Filter ainda enumera 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.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 2004 |
| cabeçalho | d3dkmthk.h |