Microsoft DirectX 8.0

IAMLatency Interface

This interface provides a method for a filter to report the amount of latency that it introduces into the graph. Latency is defined as the time that it takes the filter to process a sample. For a source filter, latency is the filter's maximum buffer size, measured in time. For example, a video capture filter that buffers one frame at 30 frames per second introduces a latency of about 33 milliseconds.

Currently, there is no support for using this interface by itself. A source filter that streams live or real-time data should implement the IAMPushSource interface, which inherits from this interface.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterfaceRetrieves pointers to supported interfaces.
AddRefIncrements the reference count.
ReleaseDecrements the reference count.
IAMLatency methodsDescription
GetLatencyRetrieves the expected latency associated with this filter.

IAMLatency::GetLatency

IAMLatency Interface

Retrieves the expected latency associated with this filter.

Syntax

HRESULT GetLatency(
    REFERENCE_TIME *prtLatency
);

Parameters

prtLatency
[in] Pointer to a variable that receives a reference time indicating the latency.

Return Value

Returns an HRESULT value that depends on the implementation of the interface.