D3D10StateBlockMaskDisableCapture function (d3d10effect.h)

Article
02/22/2024

Disable state capturing with a state-block mask.

Syntax

HRESULT D3D10StateBlockMaskDisableCapture(
  [in, out] D3D10_STATE_BLOCK_MASK   *pMask,
  [in]      D3D10_DEVICE_STATE_TYPES StateType,
  [in]      UINT                     RangeStart,
  [in]      UINT                     RangeLength
);

Parameters

[in, out] pMask

Type: D3D10_STATE_BLOCK_MASK*

A state block mask (see D3D10_STATE_BLOCK_MASK).

[in] StateType

Type: D3D10_DEVICE_STATE_TYPES

The type of device state to disable (see D3D10_DEVICE_STATE_TYPES).

[in] RangeStart

Type: UINT

The lower end of the range of values to set to false.

[in] RangeLength

Type: UINT

The upper end of the range of values to set to false.

Return value

Type: HRESULT

This method returns one of the following Direct3D 10 Return Codes.

Remarks

This is an example of how to call this function. It creates a mask that cannot capture and apply to geometry-shader samplers in slots 2 ~ 23.


D3D10_STATE_BLOCK_MASK stateBlockMask;
D3D10StateBlockMaskDisableCapture(&stateBlockMask, 
                                 D3D10_DST_GS_SAMPLERS, 
                                 2, 23);

Requirements

Requirement	Value
Target Platform	Windows
Header	d3d10effect.h
Library	D3D10.lib
DLL	D3D10.dll