DirectX SDK

IDirectMusicPortDownload::GetBuffer

The IDirectMusicPortDownload::GetBuffer method retrieves the IDirectMusicDownload interface pointer of a buffer whose unique identifier is known.

HRESULT GetBuffer(
  DWORD dwDLId,
  IDirectMusicDownload** ppIDMDownload
);

Parameters

dwDLId
Download identifier of the buffer. See DMUS_DOWNLOADINFO.
ppIDMDownload
Address of a variable to receive the IDirectMusicDownload interface pointer for the buffer.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return one of the following error values:

E_POINTER
DMUS_E_INVALID_DOWNLOADID
DMUS_E_NOT_DOWNLOADED_TO_PORT

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusicc.h.

See Also

IDirectMusicPortDownload::GetDLId, IDirectMusicDownload::GetBuffer, Low-Level DLS.