QueryRenderStatus

IAMVideoAccelerator::QueryRenderStatus method

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

dwTypeIndex [in]

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

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

dwFlags [in]

Specifies the type of query to perform.

ValueMeaning
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 codeDescription
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Videoacc.h

Library

Strmiids.lib

See also

Error and Success Codes
How Decoders Use IAMVideoAccelerator
IAMVideoAccelerator Interface

 

 

Community Additions

ADD
Show:
© 2016 Microsoft