PFND3DDDI_GETMULTISAMPLEMETHODLISTCB função de retorno de chamada (d3dumddi.h)
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) |