PFND3D10DDI_CLEARDEPTHSTENCILVIEW função de retorno de chamada (d3d10umddi.h)
A função ClearDepthStencilView limpa a exibição de estêncil de profundidade associada no momento especificada.
Sintaxe
PFND3D10DDI_CLEARDEPTHSTENCILVIEW Pfnd3d10ddiCleardepthstencilview;
void Pfnd3d10ddiCleardepthstencilview(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HDEPTHSTENCILVIEW unnamedParam2,
UINT unnamedParam3,
FLOAT unnamedParam4,
UINT8 unnamedParam5
)
{...}
Parâmetros
unnamedParam1
hDevice [in]
Um identificador para o dispositivo de exibição (contexto gráfico).
unnamedParam2
hDepthStencilView [in]
Um identificador para a exibição de estêncil de profundidade a ser limpo.
unnamedParam3
Estêncil [in]
Um valor inteiro de 8 bits sem sinal para o qual definir o estêncil.
unnamedParam4
de Profundidade [in]
Um vetor flutuante de precisão única para definir a profundidade.
unnamedParam5
sinalizadores [in]
Um valor que especifica quais partes do buffer afetar. Esse parâmetro deve ser definido como um dos seguintes valores da enumeração D3D10_DDI_CLEAR_FLAG.
| Valor | Significado |
|---|---|
| D3D10_DDI_CLEAR_DEPTH (0x01L) | O valor de profundidade (Z) é fixado ao intervalo ZNear e ZFar do visor que atualmente está associado ao slot zero usando o Microsoft Direct3D. Posteriormente, Z é preso novamente ao intervalo representável da exibição de estêncil de profundidade associada no momento usando o Direct3D novamente. |
| D3D10_DDI_CLEAR_STENCIL (0x02L) | O valor do estêncil está limpo. |
Valor de retorno
Nenhum
Observações
O driver pode usar a função de retorno de chamada pfnSetErrorCb para definir um código de erro.
As regras de ponto flutuante se aplicam à função ClearDepthStencilView.
O driver não deve encontrar nenhum erro, exceto por D3DDDIERR_DEVICEREMOVED. Portanto, se o driver passar qualquer erro, exceto por D3DDDIERR_DEVICEREMOVED, em uma chamada para a função pfnSetErrorCb, o runtime do Direct3D determinará que o erro é crítico. Mesmo que o dispositivo tenha sido removido, o driver não será necessário para retornar D3DDDIERR_DEVICEREMOVED; no entanto, se a remoção do dispositivo interferiu na operação de ClearDepthStencilView (o que normalmente não deve acontecer), o driver poderá retornar D3DDDIERR_DEVICEREMOVED.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3d10umddi.h (inclua D3d10umddi.h) |