DXGK_SETVIDPNSOURCEADDRESS_FLAGS 구조체(d3dkmddi.h)

아티클
08/07/2023

DXGK_SETVIDPNSOURCEADDRESS_FLAGS 구조체는 디스플레이 미니포트 드라이버의 DxgkDdiSetVidPnSourceAddress 또는 DxgkDdiSetVidPnSourceAddressWithMultiPlaneOverlay 함수를 호출할 때 수행할 특정 작업 유형을 식별합니다.

구문

typedef struct _DXGK_SETVIDPNSOURCEADDRESS_FLAGS {
  union {
    struct {
      UINT ModeChange : 1;
      UINT FlipImmediate : 1;
      UINT FlipOnNextVSync : 1;
      UINT FlipStereo : 1;
      UINT FlipStereoTemporaryMono : 1;
      UINT FlipStereoPreferRight : 1;
      UINT SharedPrimaryTransition : 1;
      UINT IndependentFlipExclusive : 1;
      UINT MoveFlip : 1;
#if ...
      UINT Reserved : 23;
#elif
      UINT Reserved : 24;
#elif
      UINT Reserved : 25;
#else
      UINT Reserved : 29;
#endif
    };
         UINT Value;
  };
} DXGK_SETVIDPNSOURCEADDRESS_FLAGS;

멤버

ModeChange

드라이버가 디스플레이 모드를 전환하도록 지정하는 UINT 값입니다.

이 멤버를 설정하는 것은 32비트 값 멤버(0x00000001)의 첫 번째 비트를 설정하는 것과 같습니다.

FlipImmediate

드라이버가 세로 동기화 없이 발생하는 대칭 이동 작업을 수행하도록 지정하는 UINT 값입니다.

이 멤버를 설정하는 것은 32비트 값 멤버(0x00000002)의 두 번째 비트를 설정하는 것과 같습니다.

FlipOnNextVSync

드라이버가 다음 세로 동기화에서 발생하는 대칭 이동 작업을 수행하도록 지정하는 UINT 값입니다.

이 멤버를 설정하는 것은 32비트 값 멤버(0x00000004)의 세 번째 비트를 설정하는 것과 같습니다.

[in] FlipStereo

Windows 8 부터 지원합니다.

드라이버가 스테레오 할당의 왼쪽 및 오른쪽 이미지를 모두 대칭 이동하는지 여부를 지정합니다.

DXGK_SETVIDPNSOURCEADDRESS_FLAGS 구조체의 FlipOnNextVSync 멤버가 설정된 경우 드라이버는 다음 VSync에서 왼쪽 이미지로 대칭 이동한 다음 다음 VSync에서 오른쪽 이미지로 대칭 이동을 완료합니다.

DXGK_SETVIDPNSOURCEADDRESS_FLAGS 구조체의 FlipImmediate 멤버가 설정된 경우 드라이버는 즉시 새 할당에서 검색을 시작합니다. 예를 들어 드라이버가 올바른 이미지를 검사하는 경우 새 할당의 오른쪽 이미지에 있는 동일한 상대 오프셋에서 새 검사를 시작합니다.

FlipStereo 및 FlipStereoTemporaryMono 멤버는 둘 다 동시에 설정할 수 없습니다.

자세한 요구 사항은 주의 섹션을 참조하세요.

이 멤버를 설정하는 것은 32비트 값 멤버(0x00000008)의 네 번째 비트를 설정하는 것과 같습니다.

[in] FlipStereoTemporaryMono

Windows 8 부터 지원합니다.

드라이버가 스테레오 프레임의 오른쪽 및 왼쪽 부분에 스테레오 할당의 왼쪽 이미지를 사용하는지 여부를 지정합니다. 드라이버는 FlipStereo와 동일한 현재 작업을 수행합니다. 단, 스테레오 프레임의 두 이미지를 모두 생성하기 위해 왼쪽 이미지에서만 스캔합니다.

이 멤버는 드라이버가 D3DKMDT_VIDPN_SOURCE_MODE 구조체의 Type 멤버를 D3DKMDT_RMT_GRAPHICS_STEREO_ADVANCED_SCAN 설정하여 현재 표시 모드에서 이 옵션에 대한 지원을 보고하는 경우에만 설정해야 합니다.

FlipStereo 및 FlipStereoTemporaryMono 멤버는 둘 다 동시에 설정할 수 없습니다.

FlipStereoTemporaryMono 및 FlipStereoPreferRight 멤버는 둘 다 동시에 설정할 수 없습니다.

자세한 요구 사항은 주의 섹션을 참조하세요.

이 멤버를 설정하는 것은 32비트 값 멤버(0x00000010)의 다섯 번째 비트를 설정하는 것과 같습니다.

[in] FlipStereoPreferRight

Windows 8 부터 지원합니다.

드라이버가 스테레오 기본 할당을 모노 모니터에 복제할 때 올바른 이미지를 사용하도록 지정합니다.

FlipStereoTemporaryMono 및 FlipStereoPreferRight 멤버는 둘 다 동시에 설정할 수 없습니다.

자세한 요구 사항은 주의 섹션을 참조하세요.

이 멤버를 설정하는 것은 32비트 값 멤버(0x00000020)의 여섯 번째 비트를 설정하는 것과 같습니다.

[in] SharedPrimaryTransition

Windows 8 부터 지원합니다.

드라이버가 공유 관리되는 기본 할당으로 전환 중인지 지정합니다.

다음 전환 중 하나가 발생하는 경우 이 멤버가 설정됩니다.

현재 기본 할당은 공유 기본 할당이 아니라 새 할당입니다.
현재 주 할당은 공유 기본 할당이지만 새 할당은 공유되지 않습니다.

SharedPrimaryTransition이 설정되면 디스플레이 미니포트 드라이버는 하드웨어가 기본 할당과 공유 기본 할당 간에 원활하게 전환할 수 있는지 유효성을 검사해야 하며 원활한 스위치를 만드는 데 필요한 모든 하드웨어 프로그래밍을 수행해야 합니다.

이 멤버를 설정하는 것은 32비트 값 멤버(0x00000040)의 일곱 번째 비트를 설정하는 것과 같습니다.

[in] IndependentFlipExclusive

Windows 10 부터 지원합니다.

IndependentFlipExlusive가 설정되면 대칭 이동은 독립적인 대칭 이동 전용 모드에서 수행됩니다. 전면 버퍼는 디스플레이 하드웨어(DWM이 아님)에서만 액세스되며 커널 모드 드라이버는 수직 동기화 관련 최적화를 적용할 수 있습니다.

[in] MoveFlip

Windows 10 부터 지원합니다.

MoveFlip이 설정되면 드라이버는 이전 대칭 이동에서 저장된 상태를 사용하여 새 검사 요청을 구성하라는 알림을 받습니다.

[in] Reserved

이 멤버는 예약되어 있으며 0으로 설정해야 합니다. 이 멤버를 0으로 설정하는 것은 32비트 Value 멤버의 나머지 23비트(0xFFFFFF00)를 0으로 설정하는 것과 같습니다.

Value

DXGK_SETVIDPNSOURCEADDRESS_FLAGS 작업 유형을 식별하는 32비트 값을 보유할 수 있는 를 포함하는 공용 구조체의 멤버입니다.

설명

FlipStereo, FlipStereoTemporaryMono 또는 FlipStereoPreferRight 멤버가 설정된 경우 다음 조건이 적용됩니다.

DXGKARG_SETVIDPNSOURCEADDRESS 구조체의 hAllocation 멤버는 D3DKMT_DISPLAYMODE 구조체의 Flags 멤버에 스테레오 멤버가 설정된 상태로 생성된 할당을 가리킵니다.
DXGKARG_SETVIDPNSOURCEADDRESSPrimarySegment 및 PrimaryAddress 멤버는 할당의 시작 실제 주소를 가리킵니다.
드라이버는 DXGK_SETVIDPNSOURCEADDRESS_FLAGS 구조체의 FlipImmediate 및 FlipOnNextVSync 멤버의 설정을 적용합니다.

Windows 8 시작, 디스플레이 미니포트 드라이버는 DxgkDdiSetVidPnSourceAddress 함수에 대한 호출에 실패할 수 있으며, sharedPrimaryTransition 멤버가 pSetVidPnSourceAddress-> 플래그에 설정된 경우 STATUS_INVALID_PARAMETER 반환합니다. 그러나 CheckDirectFlipSupport 함수의 사용자 모드 드라이버 구현 또는 DWM(데스크톱 창 관리자)에 오류가 없는 한 이러한 오류가 예상되지 않습니다. 이러한 오류가 발생하면 운영 체제가 컴퍼지션 모드로 원활하게 장애 복구되지 않으며 프레젠테이션이 올바르지 않습니다.