| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicPerformance8::GetGraph
The GetGraph method retrieves the toolgraph of a performance.
Syntax
HRESULT GetGraph(
IDirectMusicGraph** ppGraph
);
Parameters
ppGraph
Address of a variable that receives a pointer to the toolgraph.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| DMUS_E_NOT_FOUND |
| E_POINTER |
Remarks
The reference count of the graph is incremented.
The performance object implements IDirectMusicGraph directly This interface is used primarily to call the IDirectMusicGraph8::StampPMsg method directly on the performance. This has nothing to do with a graph object that might be embedded in the performance. If you want to access an embedded object, you are accessing a different IDirectMusicGraph interface because it is an interface on the embedded graph object, not the performance itself. To obtain an interface to an embedded audiopath, use the IDirectMusicAudioPath8::GetObjectInPath or IDirectMusicSegmentState8::GetObjectInPath method.
Requirements
Header: Declared in dmusici.h.
See Also
- DirectMusic Tools
- IDirectMusicPerformance8 Interface
- IDirectMusicPerformance8::SendPMsg
- IDirectMusicPerformance8::SetGraph
- IDirectMusicSegment8::GetGraph
© 2004 Microsoft Corporation. All rights reserved.