IDirectMusicSegment8::AddNotificationType

DirectMusic

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.