Compartir a través de


PFND3D10DDI_CLEARDEPTHSTENCILVIEW función de devolución de llamada (d3d10umddi.h)

La función ClearDepthStencilView borra la vista de galería de símbolos de profundidad enlazada actualmente especificada.

Sintaxis

PFND3D10DDI_CLEARDEPTHSTENCILVIEW Pfnd3d10ddiCleardepthstencilview;

void Pfnd3d10ddiCleardepthstencilview(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HDEPTHSTENCILVIEW unnamedParam2,
  UINT unnamedParam3,
  FLOAT unnamedParam4,
  UINT8 unnamedParam5
)
{...}

Parámetros

unnamedParam1

hDevice [in]

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

hDepthStencilView [in]

Identificador de la vista de galería de símbolos de profundidad que se va a borrar.

unnamedParam3

Galería de símbolos [in]

Valor entero de 8 bits sin signo en el que se va a establecer la galería de símbolos.

unnamedParam4

Profundidad [in]

Vector float de precisión única en el que se va a establecer la profundidad.

unnamedParam5

Marcas [in]

Valor que especifica qué partes del búfer se van a afectar. Este parámetro debe establecerse en uno de los siguientes valores de la enumeración D3D10_DDI_CLEAR_FLAG.

Valor Significado
D3D10_DDI_CLEAR_DEPTH (0x01L) El valor de profundidad (Z) se fija en el intervalo ZNear y ZFar de la ventanilla que está enlazado actualmente a cero de ranura mediante Microsoft Direct3D. Después, Z se vuelve a sujetar al intervalo que se puede representar de la vista de galería de símbolos de profundidad enlazada actualmente mediante Direct3D.
D3D10_DDI_CLEAR_STENCIL (0x02L) Se borra el valor de la galería de símbolos.

Valor devuelto

None

Observaciones

El controlador puede usar la función de devolución de llamada pfnSetErrorCb para establecer un código de error.

Las reglas de punto flotante se aplican a la función ClearDepthStencilView .

El controlador no debe encontrar ningún error, excepto por D3DDDIERR_DEVICEREMOVED. Por lo tanto, si el controlador pasa algún error, excepto por D3DDDIERR_DEVICEREMOVED, en una llamada a la función pfnSetErrorCb , el tiempo de ejecución de Direct3D determinará que el error es crítico. Incluso si se quitó el dispositivo, no es necesario que el controlador devuelva D3DDDIERR_DEVICEREMOVED; Sin embargo, si la eliminación del dispositivo interfirió con el funcionamiento de ClearDepthStencilView (que normalmente no debería ocurrir), el controlador puede devolver D3DDDIERR_DEVICEREMOVED.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado d3d10umddi.h (incluya D3d10umddi.h)

Consulte también

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb