ID3D11VideoDevice::CreateVideoProcessorOutputView method (d3d11.h)

Creates a resource view for a video processor, describing the output sample for the video processing operation.

Syntax

HRESULT CreateVideoProcessorOutputView(
  [in]  ID3D11Resource                               *pResource,
  [in]  ID3D11VideoProcessorEnumerator               *pEnum,
  [in]  const D3D11_VIDEO_PROCESSOR_OUTPUT_VIEW_DESC *pDesc,
  [out] ID3D11VideoProcessorOutputView               **ppVPOView
);

Parameters

[in] pResource

A pointer to the ID3D11Resource interface of the output surface. The resource must be created with the D3D11_BIND_RENDER_TARGET flag. See D3D11_BIND_FLAG.

[in] pEnum

A pointer to the ID3D11VideoProcessorEnumerator interface that specifies the video processor. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessorEnumerator.

[in] pDesc

A pointer to a D3D11_VIDEO_PROCESSOR_OUTPUT_VIEW_DESC structure that describes the view.

[out] ppVPOView

Receives a pointer to the ID3D11VideoProcessorOutputView interface. The caller must release the resource. If this parameter is NULL, the method checks whether the view is supported, but does not create the view.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Set the ppVPOView parameter to NULL to test whether a view is supported.

Resources used for video processor output views must use the following D3D11_BIND_FLAG combinations:

• D3D11_BIND_RENDER_TARGET indicates that it can be used for a video processor output view. The following bind flags are allowed to be set with D3D11_BIND_RENDER_TARGET:
  • D3D11_BIND_VIDEO_ENCODER
  • D3D11_BIND_SHADER_RESOURCE
• Other restrictions will apply such as:
  • No multi-sampling is allowed.
  • The Texture2D must have been created using D3D11_USAGE_DEFAULT.
• Some YUV formats can be supported as a video processor output view, but might not be supported as a 3D render target. D3D11 will allow the D3D11_BIND_RENDER_TARGET flag for these formats, but CreateRenderTargetView will not be allowed for these formats.

If stereo output is enabled, the output view must have 2 array elements. Otherwise, it must only have a single array element.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps | UWP apps]
Minimum supported server	Windows Server 2012 [desktop apps | UWP apps]
Target Platform	Windows
Header	d3d11.h

See also

ID3D11VideoDevice