PFND3D10DDI_SO_SETTARGETS função de retorno de chamada (d3d10umddi.h)
A função SoSetTargets define recursos de destino de saída de fluxo.
Sintaxe
PFND3D10DDI_SO_SETTARGETS Pfnd3d10ddiSoSettargets;
void Pfnd3d10ddiSoSettargets(
D3D10DDI_HDEVICE unnamedParam1,
[in] UINT NumBuffers,
[in] UINT ClearTargets,
const D3D10DDI_HRESOURCE *unnamedParam4,
const UINT *unnamedParam5
)
{...}
Parâmetros
unnamedParam1
hDevice [in]
Um identificador para o dispositivo de exibição (contexto gráfico).
[in] NumBuffers
O número de elementos na matriz que phResource especifica.
[in] ClearTargets
O número de identificadores para transmitir recursos de destino de saída que representa a diferença entre o número anterior de recursos de destino de saída de fluxo (antes que o runtime do Microsoft Direct3D chame SoSetTargets) e o novo número de recursos de destino de saída de fluxo.
Observe que o número que iClearTargets especifica é apenas um auxílio de otimização porque o driver de exibição no modo de usuário pode calcular esse número.
unnamedParam4
phResource [in]
Uma matriz de identificadores para os recursos de destino de saída de fluxo a serem definidos. Observe que alguns valores de identificador podem ser NULL.
unnamedParam5
pOffsets [in]
Uma matriz de deslocamentos, em bytes, para os recursos de destino de saída de fluxo na matriz especificada por phResource .
Retornar valor
Nenhum
Comentários
O driver pode usar a função de retorno de chamada pfnSetErrorCb para definir um código de erro.
O intervalo de recursos de destino de saída de fluxo entre o número especificado pelo parâmetro SOTargets e o número máximo de recursos de destino de saída de fluxo permitidos é necessário para conter todos os valores NULL ou não associados. O número especificado pelo parâmetro ClearTargets informa ao driver sobre quantos pontos de associação o driver deve limpar para a operação atual. Se a chamada anterior para SoSetTargets passou um valor de 2 em SOTargetse a chamada atual para SoSetTargets passa um valor de 4 em SOTargets, a chamada atual para SoSetTargets também passa um valor de 0 no parâmetro ClearTargets . Se a próxima chamada sucessiva para SoSetTargets passar um valor de 1 em SOTargets, a chamada sucessiva também passará um valor de 3 (4 - 1) em ClearTargets.
O driver não deve encontrar nenhum erro, exceto por D3DDDIERR_DEVICEREMOVED. Portanto, se o driver passar algum erro, exceto por D3DDDIERR_DEVICEREMOVED, em uma chamada para a função pfnSetErrorCb , o runtime do Microsoft Direct3D determinará que o erro é crítico. Mesmo que o dispositivo tenha sido removido, o driver não precisará retornar D3DDDIERR_DEVICEREMOVED; no entanto, se a remoção do dispositivo interferiu na operação de SOTargets (o que normalmente não deve acontecer), o driver poderá retornar D3DDDIERR_DEVICEREMOVED.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3d10umddi.h (inclua D3d10umddi.h) |