Compartilhar via


Método ID3D10Device::SOSetTargets (d3d10.h)

Defina os buffers de saída de destino para o estágio StreamOutput , que habilita/desabilita o pipeline para transmitir dados.

Sintaxe

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

Parâmetros

[in] NumBuffers

Tipo: UINT

O número de buffer a ser associado ao dispositivo. Um máximo de quatro buffers de saída pode ser definido. Se menos de quatro forem definidos pela chamada, os slots de buffer restantes serão definidos como NULL. Consulte Observações.

[in] ppSOTargets

Tipo: ID3D10Buffer*

A matriz de buffers de saída (consulte ID3D10Buffer) para associar ao dispositivo. Os buffers devem ter sido criados com o sinalizador D3D10_BIND_STREAM_OUTPUT .

[in] pOffsets

Tipo: const UINT*

Matriz de deslocamentos para os buffers de saída de ppSOTargets, um deslocamento para cada buffer. Os valores de deslocamento devem estar em bytes.

Retornar valor

Nenhum

Comentários

Chame ID3D10Device::SOSetTargets (antes de qualquer chamada de desenho) para transmitir dados para fora; chame SOSetTargets com NULL para interromper o streaming de dados. Para obter um exemplo, consulte Exercício 01 do workshop GDC 2007, que define os rendertargets de saída de fluxo antes de chamar métodos de desenho na função RenderInstanceToStream.

Um deslocamento de -1 fará com que o buffer de saída do fluxo seja acrescentado, continuando após o último local gravado no buffer em uma passagem de saída de fluxo anterior.

Chamar esse método usando um buffer que está atualmente associado à gravação associará efetivamente NULL porque um buffer não pode ser associado como uma entrada e uma saída ao mesmo tempo.

A Camada de Depuração gerará um aviso sempre que um recurso for impedido de ser associado simultaneamente como uma entrada e uma saída, mas isso não impedirá que dados inválidos sejam usados pelo runtime.

O método não conterá uma referência às interfaces passadas. Por esse motivo, os aplicativos devem ter cuidado para não liberar uma interface atualmente em uso pelo dispositivo.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d10.h
Biblioteca D3D10.lib

Confira também

ID3D10Device Interface