D3DDDIARG_VIDEOPROCESSBLT 구조체(d3dumddi.h)

아티클
02/23/2024

D3DDDIARG_VIDEOPROCESSBLT 구조는 수행할 Microsoft VA(DirectX Video Acceleration) 비디오 처리 작업을 설명합니다.

구문

typedef struct _D3DDDIARG_VIDEOPROCESSBLT {
  [in] REFERENCE_TIME               TargetFrame;
  [in] HANDLE                       hVideoProcess;
  [in] RECT                         TargetRect;
  [in] SIZE                         ConstrictionSize;
  [in] UINT                         StreamingFlags;
  [in] DXVADDI_AYUVSAMPLE16         BackgroundColor;
  [in] DXVADDI_EXTENDEDFORMAT       DestFormat;
  [in] DXVADDI_VIDEOPROCESSBLTFLAGS DestFlags;
  [in] DXVADDI_PROCAMPVALUES        ProcAmpValues;
  [in] DXVADDI_FIXED32              Alpha;
  [in] DXVADDI_FILTERVALUES         NoiseFilterLuma;
  [in] DXVADDI_FILTERVALUES         NoiseFilterChroma;
  [in] DXVADDI_FILTERVALUES         DetailFilterLuma;
  [in] DXVADDI_FILTERVALUES         DetailFilterChroma;
  [in] DXVADDI_VIDEOSAMPLE          *pSrcSurfaces;
  [in] UINT                         NumSrcSurfaces;
} D3DDDIARG_VIDEOPROCESSBLT;

멤버

[in] TargetFrame

입력 프레임 시퀀스 내에서 출력 프레임의 위치를 식별하는 REFERENCE_TIME 값입니다. 디인터레이싱만 수행되는 경우 대상 시간은 DXVADDI_VIDEOSAMPLE 구조의 시작 멤버에 정의된 샘플의 시작 표시 시간 또는 시작 표시 시간과 종료 표시 시간 사이의 중간점과 일치해야 합니다.

프레임 속도 변환이 요청되면 TargetFrame 의 시간은 샘플의 시작 멤버에 있는 시간과 다를 수 있습니다.

[in] hVideoProcess

DirectX VA 비디오 처리 디바이스에 대한 핸들입니다. 사용자 모드 표시 드라이버는 CreateVideoProcessDevice 함수에 대한 호출에서 이 핸들을 반환합니다.

[in] TargetRect

출력 이미지가 기록되는 대상 표면 내의 위치를 설명하는 RECT 구조체에 대한 포인터입니다. 출력 이미지는 TargetRect가 가리키는 사각형 내의 픽셀로 제한됩니다. 즉, 이 사각형 내의 모든 픽셀을 에 기록해야 합니다. 이 사각형 외부의 픽셀은 수정해서는 안 됩니다.

[in] ConstrictionSize

보호된 콘텐츠의 경우 출력 이미지를 줄일 크기를 지정하는 SIZE 구조체입니다. ConstrictionSize 는 TargetRect 멤버에 지정된 대상 사각형의 (1, 1)에서 (너비, 높이)여야 합니다. ConstrictionSize 는 수축을 나타내지 않는 (0, 0)이어야 합니다.

예를 들어 기본적으로 1920 x 1080 픽셀이 있고 출력 보호가 지원되지 않는 1920 x 1080 해상도 모니터에 전체 화면으로 표시되는 비디오를 생각해 보세요. 비디오 콘텐츠에서 원본 정보의 854 x 480픽셀만 표시할 수 있는 규칙을 지정하는 경우 드라이버는 원본 이미지를 1920 x 1080에서 854 x 480으로 줄인 다음 이미지를 다시 1920 x 1080으로 늘여야 합니다. 이 예제에서 ConstrictionSize 멤버의 SIZE 구조체는 854 x 480 픽셀의 크기를 지정합니다.

[in] StreamingFlags

스트리밍 플래그를 식별하는 UINT 값입니다. 현재 스트리밍 플래그는 정의되지 않습니다.

[in] BackgroundColor

배경색을 식별하는 DXVADDI_AYUVSAMPLE16 구조체입니다.

[in] DestFormat

대상 화면에 대한 확장 형식 정보를 식별하는 DXVADDI_EXTENDEDFORMAT 구조체입니다.

[in] DestFlags

이전 대상 표면에서 현재 대상 표면의 변경 내용을 식별하는 DXVADDI_VIDEOPROCESSBLTFLAGS 구조체입니다.

[in] ProcAmpValues

대상 화면에 출력되는 ProcAmp 조정 데이터를 지정하는 DXVADDI_PROCAMPVALUES 구조체입니다.

[in] Alpha

대상 화면에 기록되는 출력 이미지의 평면 투명도 값을 지정하는 DXVADDI_FIXED32 구조체입니다. 알파 값이 1.0이면 배경색이 불투명하게 그려집니다(투명도 및 알파 혼합 없음). 알파 값이 0.0이면 배경을 그려서는 안 됩니다(투명).

[in] NoiseFilterLuma

루마 노이즈 필터를 지정하는 DXVADDI_FILTERVALUES 구조체입니다.

[in] NoiseFilterChroma

크로마 노이즈 필터를 지정하는 DXVADDI_FILTERVALUES 구조체입니다.

[in] DetailFilterLuma

루마 세부 필터를 지정하는 DXVADDI_FILTERVALUES 구조체입니다.

[in] DetailFilterChroma

크로마 세부 필터를 지정하는 DXVADDI_FILTERVALUES 구조체입니다.

[in] pSrcSurfaces

디인터레이싱, 프레임 속도 변환 및 하위 스트림 구성 작업에 필요한 입력 샘플을 설명하는 DXVADDI_VIDEOSAMPLE 구조체의 배열입니다. 이 배열에서 입력 샘플을 정렬하는 방법에 대한 자세한 내용은 입력 버퍼 순서를 참조하세요.

[in] NumSrcSurfaces

pSrcSurfaces의 배열에 있는 입력 샘플 수입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글	d3dumddi.h(D3dumddi.h 포함)