IDirectMusicTrack8::AddNotificationType

DirectMusic

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


© 2004 Microsoft Corporation. All rights reserved.