Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicSegment8::AddNotificationType
The AddNotificationType method adds a type of event for which notifications are required. This method is called by the IDirectMusicPerformance8::AddNotificationType method, allowing the segment to generate notifications. The segment calls each track's IDirectMusicTrack8::AddNotificationType method.
Syntax
HRESULT AddNotificationType(
REFGUID rguidNotificationType
);
Parameters
rguidNotificationType
Reference to (C++) or address of (C) the identifier of the notification type to add. For the defined types, see DMUS_NOTIFICATION_PMSG. Applications can also define their own types for custom tracks.
Return Values
If the method succeeds, it returns S_OK, or S_FALSE if the type was already added.
If it fails, the method can return one of the error values shown in the following table.
Return code |
E_POINTER |
E_OUTOFMEMORY |
Remarks
Segments cannot generate notifications of type GUID_NOTIFICATION_PERFORMANCE. To get notifications of this type, you must call IDirectMusicPerformance8::AddNotificationType.
Requirements
Header: Declared in dmusici.h.
See Also
© 2004 Microsoft Corporation. All rights reserved.