Metodo ID3D11Device::CheckMultisampleQualityLevels (d3d11.h)
Ottenere il numero di livelli di qualità disponibili durante il multicampionamento.
Sintassi
HRESULT CheckMultisampleQualityLevels(
[in] DXGI_FORMAT Format,
[in] UINT SampleCount,
[out] UINT *pNumQualityLevels
);
Parametri
[in] Format
Tipo: DXGI_FORMAT
Formato trama. Vedere DXGI_FORMAT.
[in] SampleCount
Tipo: UINT
Numero di campioni durante il multicampionamento.
[out] pNumQualityLevels
Tipo: UINT*
Numero di livelli di qualità supportati dall'adapter. Vedere Osservazioni.
Valore restituito
Tipo: HRESULT
Questo metodo restituisce uno dei codici restituiti Direct3D 11 seguenti.
Commenti
Quando si esegue il multicampionamento di una trama, il numero di livelli di qualità disponibili per un adattatore dipende dal formato di trama usato e dal numero di campioni richiesti. Il numero massimo di livelli di qualità è definito da D3D11_MAX_MULTISAMPLE_SAMPLE_COUNT in D3D11.h. Se questo metodo restituisce 0 (S_OK) e il parametro pNumQualityLevels di output riceve un valore positivo, il formato e la combinazione di conteggio di campioni è supportata per il dispositivo. Quando la combinazione non è supportata, questo metodo restituisce un codice HRESULT non riuscito, ovvero un intero negativo, oppure imposta pNumQualityLevels il parametro di output su zero o entrambi.
Inoltre, la definizione di un livello di qualità viene lasciata a ogni fornitore hardware per definire; tuttavia, nessuna struttura viene fornita da Direct3D per individuare queste informazioni.
Si noti che FEATURE_LEVEL_10_1 dispositivi sono necessari per supportare 4x MSAA per tutte le destinazioni di rendering tranne R32G32B32A32 e R32G32B32. FEATURE_LEVEL_11_0 dispositivi sono necessari per supportare 4x MSAA per tutti i formati di destinazione di rendering e 8x MSAA per tutti i formati di destinazione di rendering tranne i formati R32G32B32A32.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | d3d11.h |
| Libreria | D3D11.lib |