Microsoft DirectX 8.0

IQualProp Interface

This interface provides methods for retrieving performance information from video renderers. The values returned through the interface are reset each time the filter is stopped. The Video Renderer filter and the Full Screen Renderer filter expose this interface.

Applications can use this interface to retrieve video performance information.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterface Returns pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.
IQualProp methodsDescription
get_AvgFrameRate Retrieves the average frame rate achieved.
get_AvgSyncOffset Retrieves the average time difference between when a frame was due for rendering and when rendering actually began (this is returned as a value in milliseconds).
get_DevSyncOffset Retrieves the average time difference between when a frame was due for rendering and when rendering actually began (this is returned as a standard deviation).
get_FramesDrawn Retrieves the number of frames drawn since streaming started.
get_FramesDroppedInRenderer Retrieves the number of frames dropped by the renderer.
get_Jitter Expresses the average time between successive frames delivered to the video renderer.

IQualProp::get_AvgFrameRate

IQualProp Interface

Retrieves the average frame rate since streaming started.

Syntax

HRESULT get_AvgFrameRate(
    int *piAvgFrameRate
    ) PURE;

Parameters

piAvgFrameRate
Pointer to the number of frames per second (fps) since the streaming began.

Return Value

Returns an HRESULT value.

IQualProp::get_AvgSyncOffset

IQualProp Interface

Retrieves the average time difference between when the video frames should have been displayed and when they actually were.

Syntax

HRESULT get_AvgSyncOffset(
    int *piAvg
    );

Parameters

piAvg
Pointer to the time difference, expressed in milliseconds.

Return Value

Returns an HRESULT value.

IQualProp::get_DevSyncOffset

IQualProp Interface

Retrieves the average time difference between when the video frames should have been displayed and when they actually were. This method is the same as the IQualProp::get_AvgSyncOffset method except that the value returned is calculated as a standard deviation rather than as a simple average.

Syntax

HRESULT get_DevSyncOffset(
    int *piDev
    );

Parameters

piDev
Pointer to a value denoting the accuracy of the video frames displayed.

Return Value

Returns an HRESULT value.

Remarks

When playing video from networks, the presentation can often be disrupted by network glitches. For this reason, expressing the accuracy of video frames by a simple average is inappropriate. Looking at a standard deviation provides a better idea of the overall accuracy.

IQualProp::get_FramesDrawn

IQualProp Interface

Retrieves the number of frames drawn since streaming started.

Syntax

HRESULT get_FramesDrawn(
    int *pcFramesDrawn
    );

Parameters

pcFramesDrawn
Pointer to the number of frames drawn since streaming started.

Return Value

Returns an HRESULT value.

IQualProp::get_FramesDroppedInRenderer

IQualProp Interface

Retrieves the number of frames dropped by the renderer.

Syntax

HRESULT get_FramesDroppedInRenderer(
    int *pcFrames
    );

Parameters

pcFrames
Pointer to the number of frames dropped by the renderer.

Return Value

Returns an HRESULT value.

Remarks

The property page uses this method to retrieve data from the renderer.

IQualProp::get_Jitter

IQualProp Interface

Expresses the average time between successive frames delivered to the video renderer.

Syntax

HRESULT get_Jitter(
    int *piJitter
    );

Parameters

piJitter
Pointer to the standard deviation of the interframe time, in milliseconds.

Return Value

Returns an HRESULT value.