IDirectMusicPerformance::GetNotificationPMsg

Article
06/30/2006

This method retrieves a pending notification message.

HRESULT GetNotificationPMsg(
  DMUS_NOTIFICATION_PMSG** ppNotificationPMsg
);

Parameters

ppNotificationPMsg
Address of a variable to receive a pointer to a DMUS_NOTIFICATION_PMSG structure. The application retrieving this message is responsible for calling IDirectMusicPerformance::FreePMsg on it.

Return Values

If the method succeeds, the return value is S_OK or, S_FALSE if there are no more notification events to return.

If it fails, the method can return E_POINTER.

Remarks

For an example, see Handle Notifications in the tutorial on using compositions.

Requirements

OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusici.h.
Link Library: Dmusic.lib.

See Also

Notification and Event Handling | IDirectMusicPerformance::FreePMsg | DMUS_NOTIFICATION_PMSG

Last updated on Monday, April 12, 2004

© 1992-2002 Microsoft Corporation. All rights reserved.