структура D3DDDIARG_VIDEOPROCESSBLT (d3dumddi.h)

Статья
08/07/2023

Структура D3DDDIARG_VIDEOPROCESSBLT описывает операцию обработки видео с ускорением Microsoft DirectX (VA).

Синтаксис

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, определяющее расположение выходного кадра в последовательности входных кадров. Если выполняется только деинтерлейка, целевое время должно совпадать либо со временем начала отображения образца, как определено элементом Start в структуре DXVADDI_VIDEOSAMPLE , либо с серединой между начальным и конечным временем отображения.

Если запрашивается преобразование частоты кадров, время в TargetFrame может отличаться от времени в элементах Start выборки.

[in] hVideoProcess

Дескриптор устройства обработки видео DirectX VA. Драйвер отображения пользовательского режима возвращает этот дескриптор в вызове функции CreateVideoProcessDevice .

[in] TargetRect

Указатель на структуру RECT , описывающую расположение в области назначения, в которую записывается выходное изображение. Обратите внимание, что выходное изображение ограничено пикселями в прямоугольнике, на который указывает TargetRect. То есть каждый пиксель в этом прямоугольнике должен быть записан в ; пиксели за пределами этого прямоугольника не должны изменяться.

[in] ConstrictionSize

Структура SIZE , указывающая для защищенного содержимого размер, до который необходимо уменьшить выходное изображение. Значение ConstrictionSize должно быть от (1, 1) до (ширина, высота) целевого прямоугольника, указанного в элементе TargetRect . Значение ConstrictionSize должно иметь значение (0, 0), чтобы не было сужения.

Например, рассмотрим видео, которое изначально имеет размер 1920 x 1080 пикселей и отображается в полноэкранном режиме на мониторе с разрешением 1920 x 1080, для которого защита выходных данных не поддерживается. Если в видеоконтенте указано правило, согласно которому может отображаться только 854 x 480 пикселей исходной информации, драйвер должен уменьшить исходное изображение с 1920 x 1080 до 854 x 480, а затем снова растянуть изображение до 1920 x 1080. В этом примере структура SIZE в элементе ConstrictionSize задает размер 854 x 480 пикселей.

[in] StreamingFlags

Значение UINT, определяющее флаги потоковой передачи. В настоящее время флаги потоковой передачи не определены.

[in] BackgroundColor

Структура DXVADDI_AYUVSAMPLE16 , идентифицирующая цвет фона.

[in] DestFormat

Структура DXVADDI_EXTENDEDFORMAT , которая определяет сведения о расширенном формате для области назначения.

[in] DestFlags

Структура DXVADDI_VIDEOPROCESSBLTFLAGS , которая определяет изменения в текущей области назначения по сравнению с предыдущей конечной поверхностью.

[in] ProcAmpValues

Структура DXVADDI_PROCAMPVALUES , указывающая данные корректировки ProcAmp, которые выводятся на целевую поверхность.

[in] Alpha

Структура DXVADDI_FIXED32 , указывающая значение плоской прозрачности выходного изображения при его записи в область назначения. Если альфа-значение равно 1,0, цвет фона рисуется непрозрачным (без прозрачности и альфа-смешения). Если альфа-значение равно 0,0, фон не должен быть нарисован (прозрачный).

[in] NoiseFilterLuma

Структура DXVADDI_FILTERVALUES , задающая фильтр шума luma.

[in] NoiseFilterChroma

Структура DXVADDI_FILTERVALUES , задающая фильтр шума хрома.

[in] DetailFilterLuma

Структура DXVADDI_FILTERVALUES , задающая фильтр сведений luma.

[in] DetailFilterChroma

Структура DXVADDI_FILTERVALUES , указывающая фильтр сведений о хрома.

[in] pSrcSurfaces

Массив DXVADDI_VIDEOSAMPLE структур, описывающих входные образцы, необходимые для операций деинтерлейки, преобразования частоты кадров и подпотока. Дополнительные сведения об упорядочении входных примеров в этом массиве см. в разделе Порядок входного буфера.

[in] NumSrcSurfaces

Количество входных выборок в массиве в pSrcSurfaces.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть	d3dumddi.h (включая D3dumddi.h)