Edit

KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY structure (ksmedia.h)

  • Article

The KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY structure appends an event handle to a KSPROPERTY structure

Syntax

typedef struct {
  KSPROPERTY Property;
  HANDLE     NotificationEvent;
} KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY, *PKSRTAUDIO_NOTIFICATION_EVENT_PROPERTY;

Members

Property

A KSPROPERTY structure that the client initializes appropriately prior to calling KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT or KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT.

NotificationEvent

Specifies a user-mode event handle to be registered or unregistered for event notifications.

Remarks

The KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT and KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT property requests use the KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY structure to pass a user-mode event handle from the client to the driver.

The NotificationEvent member is a user-mode event handle that, when registered, receives signals as buffer DMA progresses. The notification cabability is only available upon a successful call to KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.

Requirements

Requirement Value
Minimum supported client Available in Windows Vista and later Windows operating systems.
Header ksmedia.h

See also

KSPROPERTY

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT