PFND3D10DDI_CLEARDEPTHSTENCILVIEW funzione di callback (d3d10umddi.h)
La funzione ClearDepthStencilView cancella la visualizzazione depth-stencil attualmente associata specificata.
Sintassi
PFND3D10DDI_CLEARDEPTHSTENCILVIEW Pfnd3d10ddiCleardepthstencilview;
void Pfnd3d10ddiCleardepthstencilview(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HDEPTHSTENCILVIEW unnamedParam2,
UINT unnamedParam3,
FLOAT unnamedParam4,
UINT8 unnamedParam5
)
{...}
Parametri
unnamedParam1
hDevice [in]
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
hDepthStencilView [in]
Handle per la visualizzazione depth-stencil da cancellare.
unnamedParam3
Stencil [in]
Valore intero senza segno a 8 bit su cui impostare lo stencil.
unnamedParam4
profondità [in]
Vettore float a precisione singola su cui impostare la profondità.
unnamedParam5
flag [in]
Valore che specifica le parti del buffer da influire. Questo parametro deve essere impostato su uno dei valori seguenti dell'enumerazione D3D10_DDI_CLEAR_FLAG.
| Valore | Significato |
|---|---|
| D3D10_DDI_CLEAR_DEPTH (0x01L) | Il valore di profondità (Z) è bloccato all'intervallo ZNear e ZFar del riquadro di visualizzazione attualmente associato allo slot zero usando Microsoft Direct3D. Successivamente, Z viene nuovamente bloccato all'intervallo rappresentabile della visualizzazione depth-stencil attualmente associata usando di nuovo Direct3D. |
| D3D10_DDI_CLEAR_STENCIL (0x02L) | Il valore dello stencil viene cancellato. |
Valore restituito
Nessuno
Osservazioni
Il driver può usare il pfnSetErrorCb funzione di callback per impostare un codice di errore.
Le regole a virgola mobile si applicano alla funzione ClearDepthStencilView.
Il driver non deve riscontrare alcun errore, ad eccezione di D3DDDIERR_DEVICEREMOVED. Pertanto, se il driver passa qualsiasi errore, ad eccezione di D3DDDIERR_DEVICEREMOVED, in una chiamata alla funzione pfnSetErrorCb, il runtime Direct3D determinerà che l'errore è critico. Anche se il dispositivo è stato rimosso, il driver non è necessario per restituire D3DDDIERR_DEVICEREMOVED; Tuttavia, se la rimozione del dispositivo interferisce con l'operazione di ClearDepthStencilView (che in genere non dovrebbe accadere), il driver può restituire D3DDDIERR_DEVICEREMOVED.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | d3d10umddi.h (include D3d10umddi.h) |