IAMVideoAccelerator::QueryRenderStatus method (videoacc.h)

Article
4/26/2023

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The QueryRenderStatus method queries the read/write status of a DirectX Video Acceleration (DXVA) decoding surface.

Syntax

HRESULT QueryRenderStatus(
  [in] DWORD dwTypeIndex,
  [in] DWORD dwBufferIndex,
  [in] DWORD dwFlags
);

Parameters

[in] dwTypeIndex

Specifies the type of surface to query:

For a compressed surface, specify one of the DXVA surface types defined in dxva.h.
For an uncompressed output surface, set this parameter to 0xFFFFFFFF.

[in] dwBufferIndex

The zero-based index of the surface, within the pool of surfaces that were allocated for the specified surface type.

[in] dwFlags

Specifies the type of query to perform.

Value	Meaning
Zero	Test whether the surface is safe to use for writing.
AMVA_QUERYRENDERSTATUSF_READ	Test whether the surface is safe to use for reading.

Return value

Returns an HRESULT value. Possible values include the following:

Return code	Description
E_PENDING	The operation is still in progress.
S_OK	The operation is complete.
VFW_E_INVALIDSUBTYPE	The decoder did not use a DXVA decoding type when it connected to the video renderer.
VFW_E_NOT_CONNECTED	The pins on the decoder and video renderer filters are not connected.

Remarks

If the filter's pins are not connected, the method returns VFW_E_NOT_CONNECTED.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	videoacc.h
Library	Strmiids.lib

Share via