PFND3DDDI_GETMULTISAMPLEMETHODLISTCB funzione di callback (d3dumddi.h)
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) |