IDiscFormat2TrackAtOnce::get_TotalSectorsOnMedia method (imapi2.h)

Retrieves the total sectors available on the media if writing one continuous audio track.

Syntax

HRESULT get_TotalSectorsOnMedia(
  [out] LONG *value
);

Parameters

[out] value

Number of all sectors on the media that can be used for audio if one continuous audio track was recorded.

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

This property can be retrieved at any time; however, during writing, the value is cached.

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

See also

IDiscFormat2Data::get_FreeSectorsOnMedia

IDiscFormat2Data::get_TotalSectorsOnMedia

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce::get_FreeSectorsOnMedia

IDiscFormat2TrackAtOnce::get_UsedSectorsOnMedia