KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY structure

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

Version

Available in Windows Vista and later Windows operating systems.

Header

Ksmedia.h

See also

KSPROPERTY
KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT
KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

 

 

Send comments about this topic to Microsoft

Show: