estrutura D3DHAL_DP2SETSTREAMSOURCE (d3dhal.h)

Artigo
02/23/2024

Somente o DirectX 8.0 e versões posteriores.

A estrutura D3DHAL_DP2SETSTREAMSOURCE é usada para associar uma fonte de fluxo de vértice a um buffer de vértice para D3dDrawPrimitives2.

Sintaxe

typedef struct _D3DHAL_DP2SETSTREAMSOURCE {
  DWORD dwStream;
  DWORD dwVBHandle;
  DWORD dwStride;
} D3DHAL_DP2SETSTREAMSOURCE;

Membros

dwStream

Especifica o fluxo que está sendo associado. Ele tem um valor entre zero e o número máximo de fluxos especificados pelo driver.

dwVBHandle

Especifica o identificador de buffer de vértice. É legal que o identificador de buffer de vértice seja zero, caso em que o fluxo não está mais associado a um buffer de vértice.

dwStride

Especifica o tamanho do vértice em bytes.

Comentários

Um driver é notificado sobre a associação de um buffer de vértice a um fluxo específico por meio de um novo token DP2, D3DDP2OP_SETSTREAMSOURCE.

O runtime de depuração valida que dwStream está dentro do intervalo legal, mas a versão de varejo não, portanto, a validação deve estar presente no driver. O DirectX 8.0 não define o comportamento do driver ou hardware no caso de erro em que o índice de fluxo fornecido é maior do que o fluxo máximo suportado pelo hardware (conforme relatado por meio do MaxStreams no D3DCAPS8) além de exigir que a combinação de driver e hardware não seja falha ou travada nesse caso e que, na restauração do estado correto, a combinação de driver e hardware deve continuar funcionando normalmente. As versões de depuração do driver de exibição devem exibir mensagens no fluxo de saída de depuração indicando quando esse problema foi detectado.

O runtime não valida se os fluxos acessados pelo sombreador de vértice atual não são NULL. É responsabilidade do gravador de driver garantir que o driver/hardware não falhe quando esse caso de erro surgir. As versões de depuração do driver de exibição devem exibir mensagens no fluxo de saída de depuração para indicar quando esse problema foi detectado.

Apenas uma única fonte de fluxo é definida por uma estrutura de D3DHAL_DP2COMMAND . Ou seja, o campo wStateCount do D3DHAL_DP2COMMAND é sempre um quando bCommand é D3DDP2OP_SETSTREAMSOURCE.