Edit

PERFINFO_DSHOW_AUDIOBREAK structure

  • Article

[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 PERFINFO_DSHOW_AUDIOBREAK structure contains data for a trace event of type GUID_AUDIOBREAK.

The DirectSound Renderer filter logs this event when there is a break in the audio stream.

Syntax

typedef struct PERFINFO_DSHOW_AUDIOBREAK {
  ULONGLONG cycleCounter;
  ULONGLONG dshowClock;
  ULONGLONG sampleTime;
  ULONGLONG sampleDuration;
} PERFINFO_DSHOW_AUDIOBREAK, *PPERFINFO_DSHOW_AUDIOBREAK;

Members

cycleCounter

Latest clock cycle count (RDTSC instruction).

dshowClock

Current write position in the DirectSound buffer.

sampleTime

Start of the audio break in the DirectSound buffer.

sampleDuration

Duration of the break, in milliseconds.

Remarks

To enable this event, you must set the AUDIOBREAK_BIT flag in the EnableFlag parameter when you call EnableTrace. This flag is defined in the header file Dxmperf.h, which is included in the DirectShow base classes.

To log this event from a DirectShow filter, use the PERFLOG_AUDIOBREAK macro, which is defined in Dxmperf.h.

Requirements

Requirement Value
Header
Perfstruct.h

See also

DirectShow Structures

Event Tracing in DirectShow

Trace Event GUIDs