| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicTrack8::AddNotificationType
The AddNotificationType method adds a type of event for which notifications are required. It is similar to, and called by, the IDirectMusicSegment8::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, the return value is S_OK, or S_FALSE if the track does not support the notification type.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| DMUS_E_NOT_INIT |
| E_NOTIMPL |
Remarks
If the track does not support notifications, the method returns E_NOTIMPL. A motif or style track returns DMUS_E_NOT_INIT if it has not been initialized.
Requirements
Header: Declared in dmplugin.h.
See Also
- IDirectMusicTrack8 Interface
- IDirectMusicTrack8::RemoveNotificationType
- Notification and Event Handling
© 2004 Microsoft Corporation. All rights reserved.