Export (0) Print
Expand All
Expand Minimize

VideoProcessorSetStreamStereoFormat function

Enables or disables stereo 3D video for an input stream on the video processor. In addition, this function specifies the layout of the video frames in memory.

Syntax


VOID APIENTRY* VideoProcessorSetStreamStereoFormat(
  _In_  D3D10DDI_HDEVICE hDevice,
  _In_  D3D11_1DDI_HVIDEOPROCESSOR hVideoProcessor,
  _In_  UINT StreamIndex,
  _In_  BOOL Enable,
  _In_  D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT StereoFormat,
  _In_  BOOL LeftViewFrame0,
  _In_  BOOL BaseViewFrame0,
  _In_  D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FLIP_MODE FlipMode,
  _In_  int MonoOffset
);

Parameters

hDevice [in]

A handle to the display device (graphics context).

hVideoProcessor [in]

A handle to the video processor object that was created through a call to the CreateVideoProcessor function.

StreamIndex [in]

The zero-based index of the input stream.

Enable [in]

If TRUE, stereo 3D is enabled for the input stream.

If FALSE, stereo 3D is disabled for the input stream. The driver must ignore the remaining parameters for this function.

StereoFormat [in]

Specifies the layout of the two stereo views in memory, as a D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT value.

LeftViewFrame0 [in]

If TRUE, frame 0 contains the left view. Otherwise, frame 0 contains the right view.

This parameter is ignored for the following D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT values:

  • D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_MONO

  • D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET

BaseViewFrame0 [in]

If TRUE, frame 0 contains the base view. Otherwise, frame 1 contains the base view.

This parameter is ignored for the following D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT values:

  • D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_MONO

  • D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET

FlipMode [in]

A D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FLIP_MODE enumeration value that specifies whether one of the views is flipped.

MonoOffset [in]

If the StereoFormat parameter is set to D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET, this parameter specifies how to generate the left and right views. For more information, see the Remarks section.

Note  If the StereoFormat parameter is not set to D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET, this parameter must be set to zero and ignored by the driver.

Return value

This function does not return a value.

Remarks

For stereo formats of D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET, the driver processes the MonoOffset parameter in the following way:

  • If the parameter is positive, the right view is shifted to the right by that many pixels, and the left view is shifted to the left by the same amount.

  • If the parameter is negative, the right view is shifted to the left by that many pixels, and the left view is shifted to the right by the same amount.

For stereo formats of D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, the application can set the BaseViewFrame0 parameter to convert stereo data to mono. The application does this in one of the following ways:

  • Specifies a single resource for the mono input data of the base view.

  • Specify both resources for the stereo input data of the base view. When VideoProcessorBlt is called, the stream data is passed as a D3D11_1DDI_VIDEO_PROCESSOR_STREAM structure, with the hInputSurface member specifying frame 0 and the hInputSurfaceRight specifying frame 1.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

D3d10umddi.h (include D3d10umddi.h)

See also

CreateVideoProcessor
D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FLIP_MODE
D3D11_1DDI_VIDEO_PROCESSOR_STEREO_FORMAT
D3D11_1DDI_VIDEO_PROCESSOR_STREAM
VideoProcessorBlt

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft