IRedbookDiscMaster Interface

IID_IRedbookDiscMaster

{E3BC42CD-4E5C-11D3-9144-00104BA11C5E}

The IRedbookDiscMaster interface enables the staging of an audio CD image. It represents one of the formats supported by MSDiscMasterObj, and it allows the creation of multi-track audio discs in Track-at-Once mode (fixed-size audio gaps).

Tracks are created in the stash file, data is added to them, and then they are closed. Only one track is staged at a time; this is called the open track. The remaining tracks are closed and committed to the image, while the open track has available to it all the blocks that are not in use by closed tracks.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IRedbookDiscMaster Methods

Description

GetTotalAudioTracks

Returns total tracks staged in the image.

GetTotalAudioBlocks

Returns total audio blocks available on disc.

GetUsedAudioBlocks

Returns total audio blocks staged in image.

GetAvailableAudioTrackBlocks

Returns blocks available for current track.

GetAudioBlockSize

Returns the audio block size in bytes (2352).

CreateAudioTrack

Indicates a new audio track to be staged.

AddAudioTrackBlocks

Adds blocks of audio to track being staged.

CloseAudioTrack

Closes out staging of an audio track.

GetTotalAudioTracks

FUNCTION IRedbookDiscMaster_GetTotalAudioTracks ( _
  BYVAL pthis AS DWORD PTR _

, BYREF pnTracks AS LONG _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IRedbookDiscMaster_GetTotalAudioTracks (pthis, pnTracks) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetTotalAudioBlocks

FUNCTION IRedbookDiscMaster_GetTotalAudioBlocks ( _
  BYVAL pthis AS DWORD PTR _

, BYREF pnBlocks AS LONG _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IRedbookDiscMaster_GetTotalAudioBlocks (pthis, pnBlocks) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetUsedAudioBlocks

FUNCTION IRedbookDiscMaster_GetUsedAudioBlocks ( _
  BYVAL pthis AS DWORD PTR _

, BYREF pnBlocks AS LONG _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IRedbookDiscMaster_GetUsedAudioBlocks (pthis, pnBlocks) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetAvailableAudioTrackBlocks

FUNCTION IRedbookDiscMaster_GetAvailableAudioTrackBlocks ( _
  BYVAL pthis AS DWORD PTR _

, BYREF pnBlocks AS LONG _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IRedbookDiscMaster_GetAvailableAudioTrackBlocks (pthis, pnBlocks) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetAudioBlockSize

FUNCTION IRedbookDiscMaster_GetAudioBlockSize ( _
  BYVAL pthis AS DWORD PTR _

, BYREF pnBlockBytes AS LONG _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IRedbookDiscMaster_GetAudioBlockSize (pthis, pnBlockBytes) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

CreateAudioTrack

FUNCTION IRedbookDiscMaster_CreateAudioTrack ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL nBlocks AS LONG _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[8] USING IRedbookDiscMaster_CreateAudioTrack (pthis, nBlocks) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

AddAudioTrackBlocks

FUNCTION IRedbookDiscMaster_AddAudioTrackBlocks ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL pby AS BYTE PTR _

, BYVAL cb AS LONG _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[9] USING IRedbookDiscMaster_AddAudioTrackBlocks (pthis, pby, cb) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

CloseAudioTracks

FUNCTION IRedbookDiscMaster_CloseAudioTrack ( _
  BYVAL pthis AS DWORD PTR _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[10] USING IRedbookDiscMaster_CloseAudioTrack (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION