IDiscFormat2TrackAtOnce::get_FreeSectorsOnMedia method (imapi2.h)

Article
02/22/2024

Retrieves the number of sectors available for adding a new track to the media.

Syntax

HRESULT get_FreeSectorsOnMedia(
  [out] LONG *value
);

Parameters

[out] value

Number of available sectors on the media that can be used for writing audio.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Return code	Description
E_POINTER	Pointer is not valid. Value: 0x80004003
E_IMAPI_DF2TAO_MEDIA_IS_NOT_PREPARED	The media is not prepared (IDiscFormat2TrackAtOnce::PrepareMedia has not been called). Value: 0xC0AA0502

Remarks

If called during an AddAudioTrack operation, the available sectors do not reflect the sectors used in writing the current audio track. Instead, the reported value is the number of available sectors immediately preceding the call to AddAudioTrack.

Requirements

Requirement	Value
Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	imapi2.h