ID3D11VideoContext::VideoProcessorSetStreamOutputRate method

Sets the rate at which the video processor produces output frames for an input stream.

Syntax

void VideoProcessorSetStreamOutputRate(
  [in]       ID3D11VideoProcessor              *pVideoProcessor,
  [in]       UINT                              StreamIndex,
  [in]       D3D11_VIDEO_PROCESSOR_OUTPUT_RATE OutputRate,
  [in]       BOOL                              RepeatFrame,
  [in] const DXGI_RATIONAL                     *pCustomRate
);

Parameters

pVideoProcessor [in]

A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor.

StreamIndex [in]

The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member.

OutputRate [in]

The output rate, specified as a D3D11_VIDEO_PROCESSOR_OUTPUT_RATE value.

RepeatFrame [in]

Specifies how the driver performs frame-rate conversion, if required.

Value	Meaning
TRUE	Repeat frames.
FALSE	Interpolate frames.

 

pCustomRate [in]

A pointer to a DXGI_RATIONAL structure. If OutputRate is D3D11_VIDEO_PROCESSOR_OUTPUT_RATE_CUSTOM, this parameter specifies the exact output rate. Otherwise, this parameter is ignored and can be NULL.

Return value

This method does not return a value.

Remarks

The standard output rates are normal frame-rate (D3D11_VIDEO_PROCESSOR_OUTPUT_RATE_NORMAL) and half frame-rate (D3D11_VIDEO_PROCESSOR_OUTPUT_RATE_HALF). In addition, the driver might support custom rates for rate conversion or inverse telecine. To get the list of custom rates, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCustomRate.

Depending on the output rate, the driver might need to convert the frame rate. If so, the value of RepeatFrame controls whether the driver creates interpolated frames or simply repeats input frames.

Requirements

See also

ID3D11VideoContext