PFND3D10DDI_CLEARDEPTHSTENCILVIEW função de retorno de chamada (d3d10umddi.h)

  • Artigo

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 limpa.

unnamedParam3

Estêncil [in]

Um valor inteiro de 8 bits sem sinal para definir o estêncil.

unnamedParam4

Profundidade [in]

Um vetor float 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 no intervalo ZNear e ZFar do visor que está associado atualmente ao slot zero usando o Microsoft Direct3D. Posteriormente, Z é fixado 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 é limpo.

Retornar valor

Nenhum

Comentários

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 para 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 precisará 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
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Confira também

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb