PFND3DDDI_GETMULTISAMPLEMETHODLISTCB funzione di callback (d3dumddi.h)

Articolo
08/07/2023

La funzione pfnGetMultisampleMethodListCb recupera un elenco di metodi di esempio multipli usati per la larghezza, l'altezza e il formato specificati di un'allocazione.

Sintassi

PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;

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

Parametri

hAdapter

Handle per l'oggetto scheda grafica.

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDICB_GETMULTISAMPLEMETHODLIST che descrive l'elenco di metodi di esempio multipli per un'allocazione.

Valore restituito

pfnGetMultisampleMethodListCb restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	L'elenco di metodi di esempio multipli è stato recuperato correttamente.
E_INVALIDARG	I parametri sono stati convalidati e determinati per essere non corretti.

Questa funzione potrebbe anche restituire altri valori HRESULT.

Commenti

Il driver di visualizzazione in modalità utente usa in genere la funzione pfnGetMultisampleMethodListCb con la relativa funzione CreateResource, CreateResource (D3D10)o CreateResource(D3D11) e la funzione pfnAllocateCb. Il driver usa pfnGetMultisampleMethodListCb quando il runtime Direct3D chiama il driver CreateResource, CreateResource(D3D10)o CreateResource(D3D11) per richiedere che il driver crei una primaria a più campioni. Il driver usa anche pfnGetMultisampleMethodListCb quando deve eseguire più campionamento durante l'analisi dal primario. Questo tipo di campionamento multiplo potrebbe utilizzare una larghezza di banda di memoria aggiuntiva, oltre la larghezza di banda necessaria per l'analisi della modalità di visualizzazione. Di conseguenza, pfnGetMultisampleMethodListCb esegue una query sul gestore della modalità di visualizzazione (DMM) e indirettamente sul driver miniport visualizzato per recuperare un elenco di metodi di campionamento supportati per la larghezza, l'altezza e il formato specificati. Se pfnGetMultisampleMethodListCb segnala che non sono supportati metodi, il driver di visualizzazione in modalità utente deve usare una versione nonscan-out di più campionamento, in genere creando una primaria non multimultiple standard.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	d3dumddi.h (include D3dumddi.h)