PFND3D10DDI_CLEARDEPTHSTENCILVIEW fonction de rappel (d3d10umddi.h)

Article
02/26/2024

La fonction ClearDepthStencilView efface la vue de gabarit de profondeur actuellement liée.

Syntaxe

PFND3D10DDI_CLEARDEPTHSTENCILVIEW Pfnd3d10ddiCleardepthstencilview;

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

Paramètres

unnamedParam1

hDevice [in]

Handle pour le périphérique d’affichage (contexte graphique).

unnamedParam2

hDepthStencilView [in]

Handle de la vue profondeur-gabarit à effacer.

unnamedParam3

Gabarit [in]

Valeur entière 8 bits non signée sur laquelle définir le gabarit.

unnamedParam4

Profondeur [in]

Vecteur float simple précision sur lequel définir la profondeur.

unnamedParam5

Indicateurs [in]

Valeur qui spécifie les parties de la mémoire tampon à affecter. Ce paramètre doit être défini sur l’une des valeurs suivantes de l’énumération D3D10_DDI_CLEAR_FLAG.

Valeur	Signification
D3D10_DDI_CLEAR_DEPTH (0x01L)	La valeur de profondeur (Z) est limitée à la plage ZNear et ZFar de la fenêtre d’affichage qui est actuellement liée à l’emplacement zéro à l’aide de Microsoft Direct3D. Ensuite, Z est de nouveau limité à la plage représentable de la vue profondeur-gabarit actuellement liée à l’aide de Direct3D.
D3D10_DDI_CLEAR_STENCIL (0x02L)	La valeur du gabarit est effacée.

Valeur de retour

None

Remarques

Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur.

Les règles à virgule flottante s’appliquent à la fonction ClearDepthStencilView .

Le pilote ne doit rencontrer aucune erreur, à l’exception de D3DDDIERR_DEVICEREMOVED. Par conséquent, si le pilote réussit une erreur, à l’exception de D3DDDIERR_DEVICEREMOVED, dans un appel à la fonction pfnSetErrorCb , le runtime Direct3D détermine que l’erreur est critique. Même si l’appareil a été supprimé, le pilote n’est pas tenu de retourner D3DDDIERR_DEVICEREMOVED ; Toutefois, si la suppression de l’appareil interfère avec le fonctionnement de ClearDepthStencilView (ce qui ne doit généralement pas se produire), le pilote peut retourner D3DDDIERR_DEVICEREMOVED.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3d10umddi.h (incluez D3d10umddi.h)

Voir aussi

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb

Partager via