ID3D11VideoDevice::CreateVideoProcessorOutputView Method

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

Syntax

public:
HRESULT CreateVideoProcessorOutputView(
         ID3D11Resource *pResource,
         ID3D11VideoProcessorEnumerator *pEnum,
         const D3D11_VIDEO_PROCESSOR_OUTPUT_VIEW_DESC *pDesc,
         ID3D11VideoProcessorOutputView **ppVPOView
)  

Parameters

pResource
Type: ID3D11Resource *

[in] 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.

pEnum
Type: ID3D11VideoProcessorEnumerator *

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

pDesc
Type: D3D11_VIDEO_PROCESSOR_OUTPUT_VIEW_DESC *

[in] A pointer to a D3D11_VIDEO_PROCESSOR_OUTPUT_VIEW_DESC structure that describes the view.

ppVPOView
Type: ID3D11VideoProcessorOutputView **

[out, optional] 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

Type: HRESULT 

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

See Direct3D 11 return codes for possible return values.

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

Header: Declared in d3d11_x.h (d3d11.h on other Windows platforms).