|Microsoft DirectX 9.0|
The GetNotificationPMsg method retrieves a pending notification message.
HRESULT GetNotificationPMsg( DMUS_NOTIFICATION_PMSG** ppNotificationPMsg );
Address of a variable that receives a pointer to a DMUS_NOTIFICATION_PMSG structure. The application retrieving this message is responsible for calling IDirectMusicPerformance8::FreePMsg on it.
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.
For most notifications, the segment state that generated the notification can be retrieved from the punkUser member of the message structure, and the segment can be retrieved by using IDirectMusicSegmentState8::GetSegment.
Header: Declared in dmusici.h.