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 포함) |