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

Vedi anche

ID3D11Device