PFND3D10DDI_SETSCISSORRECTS 콜백 함수(d3d10umddi.h)

SetScissorRects 함수는 렌더링이 제한된 렌더링 대상의 일부를 표시합니다.

구문

PFND3D10DDI_SETSCISSORRECTS Pfnd3d10ddiSetscissorrects;

void Pfnd3d10ddiSetscissorrects(
       D3D10DDI_HDEVICE unnamedParam1,
  [in] UINT NumRects,
  [in] UINT ClearRects,
       const D3D10_DDI_RECT *unnamedParam4
)
{...}

매개 변수

unnamedParam1

hDevice [in]

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

[in] NumRects

pRects 매개 변수가 지정하는 렌더링 대상 부분의 총 수입니다.

[in] ClearRects

NumScissorRects가 NULL로 설정하도록 지정하는 렌더링 대상 부분 수 이후의 렌더링 대상 부분 수입니다. 이 숫자는 이전의 렌더링 대상 부분 수(즉, 이전에 SetScissorRects라고 하는 Microsoft Direct3D 런타임)와 새 렌더링 대상 부분 수 간의 차이를 나타냅니다.

ClearScissorRects가 지정하는 숫자는 사용자 모드 표시 드라이버가 이 숫자를 계산할 수 있기 때문에 최적화에만 도움이 됩니다.

unnamedParam4

pRects [in]

표시할 렌더링 대상 부분에 대한 RECT 구조체의 배열입니다.

반환 값

없음

설명

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

D3D10_DDI_RECT 구조체는 RECT 구조체로 정의됩니다.

typedef RECT D3D10_DDI_RECT;

사용자 모드 표시 드라이버는 모든 렌더링 대상 부분을 원자성으로 하나의 작업으로 설정해야 합니다.

NumScissorRects 매개 변수는 pRects 매개 변수가 지정하는 배열의 렌더링 대상 부분 수를 지정하지만 배열의 일부 값은 NULL일 수 있습니다.

NumScissorRects에서 지정하는 수와 허용되는 렌더링 대상 부분의 최대 수 사이의 렌더링 대상 부분 범위는 모든 NULL 또는 언바운드 값을 포함하는 데 필요합니다. ClearScissorRects 매개 변수가 지정하는 숫자는 드라이버가 현재 원자성 작업을 위해 지워야 하는 렌더링 대상 부분의 수를 드라이버에 알릴 수 있습니다.

SetScissorRects에 대한 이전 호출이 NumScissorRects 매개 변수에서 값 2를 전달하고 SetScissorRects에 대한 현재 호출이 NumScissorRects에서 4 값을 전달하는 경우 SetScissorRects에 대한 현재 호출은 ClearScissorRects 매개 변수에서도 0 값을 전달합니다. SetScissorRects에 대한 다음 연속 호출이 NumScissorRects에서 1 값을 전달하는 경우 연속 호출은 ClearScissorRects에서 3(4 - 1) 값을 전달합니다.

사용자 모드 쿼리 작업 중에 명확한 렌더링 대상 부분의 값을 요청하는 경우 값은 렌더링 대상 부분의 최대 수와 렌더링 대상 부분 값 간의 차이입니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	d3d10umddi.h(D3d10umddi.h 포함)

추가 정보

D3D10DDI_DEVICEFUNCS

RECT

pfnSetErrorCb