DXGK_SETVIDPNSOURCEADDRESS_FLAGS 구조체(d3dkmddi.h)

아티클
02/06/2025

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비트 Value 멤버(0x00000001)의 첫 번째 비트를 설정하는 것과 같습니다.

FlipImmediate

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

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

FlipOnNextVSync

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

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

[in] FlipStereo

Windows 8부터 지원됩니다.

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

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

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

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

자세한 요구 사항은 설명 섹션을 참조하세요.

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

[in] FlipStereoTemporaryMono

Windows 8부터 지원됩니다.

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

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

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

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

자세한 요구 사항은 설명 섹션을 참조하세요.

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

[in] FlipStereoPreferRight

Windows 8부터 지원됩니다.

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

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

자세한 요구 사항은 설명 섹션을 참조하세요.

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

[in] SharedPrimaryTransition

Windows 8부터 지원됩니다.

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

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

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

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

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

[in] IndependentFlipExclusive

Windows 10부터 지원됩니다.

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

[in] MoveFlip

Windows 10부터 지원됩니다.

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

[in] Reserved

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

Value

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

발언

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

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

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