Partager via


D3D10CreateStateBlock, fonction (d3d10effect.h)

Créez un bloc d’état.

Syntaxe

HRESULT D3D10CreateStateBlock(
  [in]  ID3D10Device           *pDevice,
  [in]  D3D10_STATE_BLOCK_MASK *pStateBlockMask,
  [out] ID3D10StateBlock       **ppStateBlock
);

Paramètres

[in] pDevice

Type : ID3D10Device*

Appareil pour lequel le bloc d’état sera créé.

[in] pStateBlockMask

Type : D3D10_STATE_BLOCK_MASK*

Indique quelles parties de l’état de l’appareil seront capturées lors de l’appel d’ID3D10StateBlock::Capture et réappliquées lors de l’appel de ID3D10StateBlock::Apply. Consultez la section Remarques.

[out] ppStateBlock

Type : ID3D10StateBlock**

Adresse d’un pointeur vers la mémoire tampon créée (voir INTERFACE ID3D10StateBlock).

Valeur retournée

Type : HRESULT

Cette méthode retourne l’un des codes de retour Direct3D 10 suivants.

Notes

Un bloc d’état est une collection de l’état de l’appareil et est utilisé pour enregistrer et restaurer l’état de l’appareil. Utilisez un masque de bloc d’état pour activer des sous-ensembles d’état pour l’enregistrement et la restauration.

La structure D3D10_STATE_BLOCK_MASK peut être remplie manuellement ou à l’aide de l’une des API D3D10StateBlockMaskXXX. Un masque de bloc d’état peut également être obtenu en appelant ID3D10EffectTechnique::ComputeStateBlockMask ou ID3D10EffectPass::ComputeStateBlockMask.

Différences entre Direct3D 9 et Direct3D 10 :

Dans Direct3D 10, un objet de bloc d’état ne contient pas d’informations valides sur l’état de l’appareil tant que ID3D10StateBlock::Capture n’est pas appelé. Dans Direct3D 9, l’état est enregistré dans un objet de bloc d’état lors de sa création.

Configuration requise

   
Plateforme cible Windows
En-tête d3d10effect.h
Bibliothèque D3D10.lib
DLL D3D10.dll

Voir aussi

Fonctions Core

Fonctions d’effet