IRawCDImageCreator::AddSpecialPregap method (imapi2.h)
Accepts the provided IStream object and saves the associated pointer to be used as data for the pre-gap for track 1.
Syntax
HRESULT AddSpecialPregap(
[in, optional] IStream *data
);
Parameters
[in, optional] data
Pointer to the provided IStream object.
Return value
S_OK is returned on success, but other success codes may be returned as a result of implementation.
Remarks
This method can only be called prior to adding any tracks to the image. The data stream must be at least 2 seconds (or 150 sectors) long.
The data stream should not result final sector exceeding LBA 397,799 (MSF 88:25:74), as the minimal-sized track plus leadout would then exceed the MSF 89:59:74 maximum. Additionally, it is recommended that the IMAPI_CD_SECTOR_TYPE value for the first track is implicitly defined as "Audio". The resulting audio can then only be heard by playing the first track and "rewinding" back to the start of the audio disc.
This method is supported in Windows Server 2003 with Service Pack 1 (SP1), Windows XP with Service Pack 2 (SP2), and Windows Vista via the Windows Feature Pack for Storage. All features provided by this update package are supported natively in Windows 7 and Windows Server 2008 R2.
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 |