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 per l'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 la funzione di callback pfnSetErrorCb per impostare un codice di errore.

Le regole a virgola mobile si applicano alla funzione ClearDepthStencilView .

Il driver non deve riscontrare errori, 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 deve restituire D3DDDIERR_DEVICEREMOVED; Tuttavia, se la rimozione del dispositivo interferisce con l'operazione di ClearDepthStencilView (che in genere non dovrebbe verificarsi), il driver può restituire D3DDDIERR_DEVICEREMOVED.

Requisiti

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)

Vedi anche

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb