ID3D11DeviceContext::SOSetTargets method

Set the target output buffers for the stream-output stage of the pipeline.

Syntax

void SOSetTargets(
  UINT         NumBuffers,
  ID3D11Buffer * const *ppSOTargets,
  const UINT   *pOffsets
);

Parameters

NumBuffers

Type: UINT

The number of buffer to bind to the device. A maximum of four output buffers can be set. If less than four are defined by the call, the remaining buffer slots are set to NULL. See Remarks.

ppSOTargets

Type: ID3D11Buffer*

The array of output buffers (see ID3D11Buffer) to bind to the device. The buffers must have been created with the D3D11_BIND_STREAM_OUTPUT flag.

pOffsets

Type: const UINT*

Array of offsets to the output buffers from ppSOTargets, one offset for each buffer. The offset values must be in bytes.

Return Value

This method does not return a value.

Remarks

An offset of -1 will cause the stream output buffer to be appended, continuing after the last location written to the buffer in a previous stream output pass.

Calling this method using a buffer that is currently bound for writing will effectively bind NULL instead because a buffer cannot be bound as both an input and an output at the same time.

The debug layer will generate a warning whenever a resource is prevented from being bound simultaneously as an input and an output, but this will not prevent invalid data from being used by the runtime.

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

Windows Phone 8: This API is supported.

Requirements

   
Target Platform Windows
Header d3d11.h
Library D3D11.lib

See Also

ID3D11DeviceContext