ID3D11VideoDevice::CreateVideoProcessorInputView Method

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

Syntax

public:
HRESULT CreateVideoProcessorInputView(
         ID3D11Resource *pResource,
         ID3D11VideoProcessorEnumerator *pEnum,
         const D3D11_VIDEO_PROCESSOR_INPUT_VIEW_DESC *pDesc,
         ID3D11VideoProcessorInputView **ppVPIView
)  

Parameters

pResource
Type: ID3D11Resource *

[in] A pointer to the ID3D11Resource interface of the input surface.

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_INPUT_VIEW_DESC *

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

ppVPIView
Type: ID3D11VideoProcessorInputView **

[out, optional] Receives a pointer to the ID3D11VideoProcessorInputView 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 ppVPIView parameter to NULL to test whether a view is supported.

The surface format is given in the FourCC member of the D3D11_VIDEO_PROCESSOR_INPUT_VIEW_DESC structure. The method fails if the video processor does not support this format as an input sample. An app must specify 0 when using 9_1, 9_2, or 9_3 feature levels.

Resources used for video processor input views must use the following bind flag combinations:

• Any combination of bind flags that includes D3D11_BIND_DECODER,D3D11_BIND_VIDEO_ENCODER, D3D11_BIND_RENDER_TARGET, and D3D11_BIND_UNORDERED_ACCESS_VIEW can be used as for video processor input views (regardless of what other bind flags may be set).
• Bind flags = 0 is also allowed for a video processor input view.
• Other restrictions will apply such as:
  • No multi-sampling is allowed.
  • The Texture2D must have been created using D3D11_USAGE_DEFAULT.

Requirements

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