다음을 통해 공유


Device.SetRenderTarget 메서드

업데이트: 2007년 11월

장치에 대한 새로운 색 버퍼를 설정합니다.

네임스페이스:  Microsoft.WindowsMobile.DirectX.Direct3D
어셈블리:  Microsoft.WindowsMobile.DirectX(Microsoft.WindowsMobile.DirectX.dll)

구문

‘선언
Public Sub SetRenderTarget ( _
    renderTarget As Surface, _
    newZStencil As Surface _
)
‘사용 방법
Dim instance As Device
Dim renderTarget As Surface
Dim newZStencil As Surface

instance.SetRenderTarget(renderTarget, _
    newZStencil)
public void SetRenderTarget(
    Surface renderTarget,
    Surface newZStencil
)
public:
void SetRenderTarget(
    Surface^ renderTarget, 
    Surface^ newZStencil
)
public function SetRenderTarget(
    renderTarget : Surface, 
    newZStencil : Surface
)

매개 변수

  • newZStencil
    형식: Microsoft.WindowsMobile.DirectX.Direct3D.Surface

    새로운 색 버퍼 Surface입니다. nullNull 참조(Visual Basic의 경우 Nothing)로 설정되어 있으면 해당 renderTarget의 색 버퍼가 사용되지 않습니다. 장치는 항상 색 버퍼와 연결되어야 합니다.

    새 렌더링 대상 표면에는 최소한 Usage가 지정되어 있어야 합니다.

예외

예외 상황
InvalidCallException

메서드 호출이 잘못된 경우. renderTarget이 null 이고 newZStencil = 0이거나, renderTarget이 null 이 아니고 렌더링 대상이 잘못된 경우

설명

장치에서 여러 렌더링 대상을 지원할 수 있습니다. 일부 하드웨어에서는 깊이 스텐실 버퍼와 색 버퍼의 호환성을 테스트합니다. 이 테스트가 수행되는 경우 디버그 빌드에서만 수행됩니다. 이 메서드를 사용할 때 다음과 같은 제한이 적용됩니다.

  • 렌더링 대상과 깊이 스텐실 표면의 MultiSampleType 형식은 동일해야 합니다.

  • 렌더링 대상과 깊이 스텐실 표면의 형식은 호환되어야 합니다. 자세한 내용은 CheckDepthStencilMatch를 참조하십시오.

  • 깊이 스텐실 표면의 크기는 렌더링 대상의 크기보다 크거나 같아야 합니다.

이러한 제한은 Device 그리기 메서드가 호출될 때 디버그 런타임을 사용하는 경우에만 확인됩니다.

권한

  • 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

플랫폼

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Compact Framework

3.5, 2.0에서 지원

참고 항목

참조

Device 클래스

Device 멤버

Microsoft.WindowsMobile.DirectX.Direct3D 네임스페이스