PFND3D10DDI_SO_SETTARGETS 콜백 함수(d3d10umddi.h)

SoSetTargets 함수는 스트림 출력 대상 리소스를 설정합니다.

구문

PFND3D10DDI_SO_SETTARGETS Pfnd3d10ddiSoSettargets;

void Pfnd3d10ddiSoSettargets(
       D3D10DDI_HDEVICE unnamedParam1,
  [in] UINT NumBuffers,
  [in] UINT ClearTargets,
       const D3D10DDI_HRESOURCE *unnamedParam4,
       const UINT *unnamedParam5
)
{...}

매개 변수

unnamedParam1

hDevice [in]

디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.

[in] NumBuffers

phResource가 지정하는 배열의 요소 수입니다.

[in] ClearTargets

이전 스트림 출력 대상 리소스 수(Microsoft Direct3D 런타임이 SoSetTargets를 호출하기 전)와 새 스트림 출력 대상 리소스 수 간의 차이를 나타내는 출력 대상 리소스를 스트리밍하는 핸들 수입니다.

사용자 모드 표시 드라이버가 이 숫자를 계산할 수 있으므로 iClearTargets 에서 지정하는 숫자는 최적화에만 도움이 됩니다.

unnamedParam4

phResource [in]

설정할 스트림 출력 대상 리소스에 대한 핸들의 배열입니다. 일부 핸들 값은 NULL일 수 있습니다.

unnamedParam5

pOffsets [in]

phResource가 지정하는 배열의 스트림 출력 대상 리소스에 대한 오프셋 배열(바이트)입니다.

반환 값

없음

설명

드라이버는 pfnSetErrorCb 콜백 함수를 사용하여 오류 코드를 설정할 수 있습니다.

SOTargets 매개 변수가 지정하는 수와 허용되는 스트림 출력 대상 리소스의 최대 수 사이의 스트림 출력 대상 리소스 범위는 모든 NULL 또는 언바운드 값을 포함하는 데 필요합니다. ClearTargets 매개 변수가 지정하는 숫자는 드라이버가 현재 작업에 대해 지워야 하는 바인딩 지점 수를 드라이버에 알릴 수 있습니다. SoSetTargets에 대한 이전 호출이 SOTargets에서 2 값을 전달하고 SoSetTargets에 대한 현재 호출이 SOTargets에서 4 값을 전달하는 경우 SoSetTargets에 대한 현재 호출도 ClearTargets 매개 변수에서 0 값을 전달합니다. SoSetTargets에 대한 다음 연속 호출이 SOTargets에서 1 값을 전달하는 경우 연속 호출은 ClearTargets에서 3(4 - 1) 값을 전달합니다.

D3DDDIERR_DEVICEREMOVED 경우를 제외하고 드라이버에 오류가 발생하지 않아야 합니다. 따라서 드라이버가 pfnSetErrorCb 함수에 대한 호출에서 D3DDDIERR_DEVICEREMOVED 경우를 제외하고 오류를 전달하는 경우 Microsoft Direct3D 런타임은 오류가 중요하다고 결정합니다. 디바이스가 제거된 경우에도 드라이버는 D3DDDIERR_DEVICEREMOVED 반환할 필요가 없습니다. 그러나 디바이스 제거가 SOTargets 작업을 방해하는 경우(일반적으로 발생하지 않아야 하는) 드라이버는 D3DDDIERR_DEVICEREMOVED 반환할 수 있습니다.

요구 사항

추가 정보

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb