Edit

Share via

ID3D11VideoDevice::CreateVideoProcessorInputView method (d3d11.h)

  • Article

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

Syntax

HRESULT CreateVideoProcessorInputView(
  [in]  ID3D11Resource                              *pResource,
  [in]  ID3D11VideoProcessorEnumerator              *pEnum,
  [in]  const D3D11_VIDEO_PROCESSOR_INPUT_VIEW_DESC *pDesc,
  [out] ID3D11VideoProcessorInputView               **ppVPIView
);

Parameters

[in] pResource

A pointer to the ID3D11Resource interface of the input surface.

[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_INPUT_VIEW_DESC structure that describes the view.

[out] ppVPIView

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

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

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

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