| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicPortDownload8::GetDLId
The GetDLId method obtains sequential identifiers for one or more download buffers.
Every memory chunk downloaded to the synthesizer must have a unique identifier placed in its DMUS_DOWNLOADINFO structure. The GetDLId method guarantees that no two downloads have the same identifier.
Syntax
HRESULT GetDLId(
DWORD* pdwStartDLId,
DWORD dwCount
);
Parameters
pdwStartDLId
Address of a variable that receives the first identifier.
dwCount
Number of identifiers to reserve. You might plan to download a whole series of chunks at once. Instead of calling GetDLId for each chunk, set dwCount to the number of chunks. GetDLId returns the first ID of the set, and the additional identifiers are automatically reserved up through *pdwStartDLId plus dwCount. A subsequent call to GetDLId would skip past the reserved values.
Return Values
If the method succeeds, it returns S_OK.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| E_POINTER |
| E_INVALIDARG |
Requirements
Header: Declared in dmusicc.h.
See Also
© 2004 Microsoft Corporation. All rights reserved.