PFND3DDDI_QUERYDLISTFORAPPLICATION2 função de retorno de chamada (d3dumddi.h)

Artigo
08/07/2023

A função de retorno de chamada PFND3DDDI_QUERYDLISTFORAPPLICATION2 consulta a dList para um aplicativo.

Sintaxe

PFND3DDDI_QUERYDLISTFORAPPLICATION2 Pfnd3dddiQuerydlistforapplication2;

HRESULT Pfnd3dddiQuerydlistforapplication2(
  [out] D3DDDI_DLIST_QUERY_RESULT *unnamedParam1,
  [out] D3DDDI_DLIST_QUERY_DECISION_FACTOR *unnamedParam2,
  [in]  HANDLE unnamedParam3,
  [in]  PFND3DDDI_ESCAPECB unnamedParam4
)
{...}

Parâmetros

[out] unnamedParam1

Ponteiro para um valor D3DDDI_DLIST_QUERY_RESULT que descreve a preferência de GPU retornada para o aplicativo consultado.

[out] unnamedParam2

Ponteiro para um valor D3DDDI_DLIST_QUERY_DECISION_FACTOR que descreve o fator que determinou a preferência de GPU retornada.

[in] unnamedParam3

Um identificador para o objeto do adaptador gráfico. Esse identificador é passado para a função de retorno de chamada pfnEscapeCb apontada por unnamedParam4.

[in] unnamedParam4

Ponteiro para uma função de retorno de chamada pfnEscapeCb que compartilha informações com o driver de miniporto de exibição.

Retornar valor

Retorna S_OK ou um resultado de erro apropriado se a operação não for bem-sucedida.

Comentários

A partir do WDDM 2.9, os drivers devem dar suporte a PFND3DDDI_QUERYDLISTFORAPPLICATION2 em vez de PFND3DDDI_QUERYDLISTFORAPPLICATION1.

A função de retorno de chamada PFND3DDDI_QUERYDLISTFORAPPLICATION2 é chamada pelo DXGI (runtime de elementos gráficos) no modo de usuário durante a inicialização do Microsoft Direct3D em um sistema híbrido para determinar em qual GPU um aplicativo deve ser executado. Uma dList é uma lista de aplicativos que precisam de superfícies compartilhadas entre adaptadores para renderização de alto desempenho na GPU discreta.

O D3DDDI_DLIST_QUERY_RESULT e D3DDDI_DLIST_QUERY_DECISION_FACTOR retornados nesta DDI ajudam o runtime a garantir e melhorar a qualidade das atualizações de conteúdo do DxDb, avaliando o risco de regressões de aplicativo para uma atualização.

Os drivers de sistema híbrido precisam configurar e registrar uma DLL dList que exporte essa função. Para obter mais informações sobre sistemas híbridos, consulte Usando recursos de adaptador cruzado em um sistema híbrido.