ID3D11DeviceContext::SOSetTargets Method

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

Syntax

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

Parameter

  • NumBuffers [in]
    Typ: 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 [in]
    Typ: 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 [in]
    Typ: const UINT*

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

Rückgabewert

Methode gibt keinen Wert zurück.

Hinweise

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.

Anforderungen

Header

D3D11.h

Bibliothek

D3D11.lib

Siehe auch

ID3D11DeviceContext