IDiscFormat2TrackAtOnce::get_FreeSectorsOnMedia method (imapi2.h)
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 |
|---|---|
|
Pointer is not valid.
Value: 0x80004003 |
|
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 |
See also
IDiscFormat2Data::get_FreeSectorsOnMedia
IDiscFormat2Data::get_TotalSectorsOnMedia