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

Artigo
02/23/2024

A função pfnGetMultisampleMethodListCb recupera uma lista de métodos de vários exemplos que são usados para a largura, altura e formato determinados de uma alocação.

Sintaxe

PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;

HRESULT Pfnd3dddiGetmultisamplemethodlistcb(
  HANDLE hAdapter,
  D3DDDICB_GETMULTISAMPLEMETHODLIST *unnamedParam2
)
{...}

Parâmetros

hAdapter

Um identificador para o objeto do adaptador gráfico.

unnamedParam2

pData [in, out]

Um ponteiro para uma estrutura D3DDDICB_GETMULTISAMPLEMETHODLIST que descreve a lista de métodos de vários exemplos para uma alocação.

Retornar valor

pfnGetMultisampleMethodListCb retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	A lista de métodos de vários exemplos foi recuperada com êxito.
E_INVALIDARG	Os parâmetros foram validados e determinados como incorretos.

Essa função também pode retornar outros valores HRESULT.

Comentários

O driver de exibição do modo de usuário normalmente usa a função pfnGetMultisampleMethodListCb com sua função CreateResource, CreateResource(D3D10)ou CreateResource(D3D11) e a função pfnAllocateCb . O driver usa pfnGetMultisampleMethodListCb quando o runtime do Direct3D chama CreateResource, CreateResource(D3D10) ou CreateResource(D3D11) do driver para solicitar que o driver crie um primário de várias amostras. O driver também usa pfnGetMultisampleMethodListCb quando deve executar várias amostras durante a verificação do primário. Esse tipo de amostragem múltipla pode consumir largura de banda de memória adicional, além da largura de banda necessária para verificar o modo de exibição. Portanto, pfnGetMultisampleMethodListCb consulta o DMM (gerenciador de modo de exibição) (e indiretamente o driver de miniporto de exibição) para recuperar uma lista de métodos de amostragem múltipla com suporte para a largura, altura e formato fornecidos. Se pfnGetMultisampleMethodListCb relatar que não há suporte para nenhum método, o driver de exibição do modo de usuário deverá usar uma versão não-descanada de amostragem múltipla, normalmente criando um primário padrão não amostrado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dumddi.h (inclua D3dumddi.h)