ID3D11DeviceContext::OMSetRenderTargets Method

Bind one or more render targets atomically and the depth-stencil buffer to the output-merger stage.

Syntax

void OMSetRenderTargets(
  [in]  UINT NumViews,
  [in]  ID3D11RenderTargetView *const **ppRenderTargetViews,
  [in]  ID3D11DepthStencilView *pDepthStencilView
);

Parameter

• NumViews [in]
  Typ: UINT

  Number of render targets to bind (ranges between 0 and D3D11_SIMULTANEOUS_RENDER_TARGET_COUNT).

• ppRenderTargetViews [in]
  Typ: ID3D11RenderTargetView**

  Pointer to an array of render targets (see ID3D11RenderTargetView) to bind to the device. If this parameter is NULL, no render targets are bound. See Remarks.

• pDepthStencilView [in]
  Typ: ID3D11DepthStencilView*

  Pointer to a depth-stencil view (see ID3D11DepthStencilView) to bind to the device. If this parameter is NULL, the depth-stencil state is not bound.

Rückgabewert

Returns nothing.

Hinweise

The maximum number of active render targets a device can have active at any given time is set by a #define in D3D11.h called D3D11_SIMULTANEOUS_RENDER_TARGET_COUNT. It is invalid to try to set the same subresource to multiple render target slots. Any render targets not defined by this call are set to NULL.

If any subresources are also currently bound for reading in a different stage or writing (perhaps in a different part of the pipeline), those bind points will be set to NULL, in order to prevent the same subresource from being read and written simultaneously in a single rendering operation.

The method will hold a reference to the interfaces passed in. This differs from the device state behavior in Direct3D 10.

If the render-target views were created from an array resource type, then all of the render-target views must have the same array size. This restriction also applies to the depth-stencil view, its array size must match that of the render-target views being bound.

The pixel shader must be able to simultaneously render to at least eight separate render targets. All of these render targets must access the same type of resource: Buffer, Texture1D, Texture1DArray, Texture2D, Texture2DArray, Texture3D, or TextureCube. All render targets must have the same size in all dimensions (width and height, and depth for 3D or array size for *Array types). If render targets use multisample anti-aliasing, all bound render targets and depth buffer must be the same form of multisample resource (that is, the sample counts must be the same). Each render target can have a different data format. These render target formats are not required to have identical bit-per-element counts.

Any combination of the eight slots for render targets can have a render target set or not set.

The same resource view cannot be bound to multiple render target slots simultaneously. However, you can set multiple non-overlapping resource views of a single resource as simultaneous multiple render targets.

Anforderungen

Siehe auch

ID3D11DeviceContext