IAMVideoAccelerator::DisplayFrame method

The DisplayFrame method causes the video renderer to display a decoded frame.

Syntax


HRESULT DisplayFrame(
  [in] DWORD        dwFlipToIndex,
  [in] IMediaSample *pMediaSample
);

Parameters

dwFlipToIndex [in]

The surface index of the decoded frame to display.

pMediaSample [in]

Pointer to the IMediaSample interface of a media sample. This sample does not contain a video frame, but is used to specify the time stamp and any sample flags. (For more information about sample flags, see AM_SAMPLE2_PROPERTIES.

Return value

Returns an HRESULT value that depends on the implementation of the interface. HRESULT can include one of the following standard constants, or other values not listed.

Return codeDescription
E_FAIL

Failure.

E_INVALIDARG

Argument is invalid.

E_NOTIMPL

Method is not supported.

E_POINTER

NULL pointer argument.

S_OK

Success.

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.

The method blocks until the video renderer finishes displaying the video frame.

The video decoder calls this method after calling IAMVideoAccelerator::EndFrame for the surface whose index is given in dwFlipToIndex. The index value must match the value of AMVABeginFrameInfo.dwDestSurfaceIndex in a previous call to IAMVideoAccelerator::BeginFrame.

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

 

 

Show: