IRawCDImageCreator-Schnittstelle (imapi2.h)
Verwenden Sie diese Schnittstelle, um ein RAW-CD-Image für die Verwendung beim Schreiben auf CD-Medien im DAO-Modus (Disc-at-Once) zu erstellen. Mit dieser Schnittstelle erstellte Bilder können mithilfe der IDiscFormat2RawCD-Schnittstelle auf CD-Medien geschrieben werden.
Um eine instance dieser Schnittstelle zu erstellen, rufen Sie die Funktion CoCreateInstance auf. Use__uuidof(MsftRawCDImageCreator) für den Klassenbezeichner und __uuidof(IRawCDImageCreator) für den Schnittstellenbezeichner.
Vererbung
Die IRawCDImageCreator-Schnittstelle erbt von der IDispatch-Schnittstelle . IRawCDImageCreator verfügt auch über folgende Membertypen:
Methoden
Die IRawCDImageCreator-Schnittstelle verfügt über diese Methoden.
| IRawCDImageCreator::AddSpecialPregap Akzeptiert das bereitgestellte IStream-Objekt und speichert den zugeordneten Zeiger, der als Daten für die Pre-Gap für Track 1 verwendet werden soll. |
| IRawCDImageCreator::AddSubcodeRWGenerator Ermöglicht das Hinzufügen einer benutzerdefinierten R-W-Untercodierung, die vom IStream bereitgestellt wird. Das bereitgestellte Objekt muss eine Größe aufweisen, die der Anzahl der Sektoren im Rohdatenträgerimage * 96 Bytes entspricht, wenn das endgültige Image erstellt wird. |
| IRawCDImageCreator::AddTrack Akzeptiert das bereitgestellte IStream-Objekt und speichert den Schnittstellenzeiger als nächste Spur im Bild. |
| IRawCDImageCreator::CreateResultImage Erstellt das endgültige IStream-Objekt basierend auf den aktuellen Einstellungen. |
| IRawCDImageCreator::get_DisableGaplessAudio Ruft den aktuellen Wert ab, der angibt, ob die Aufzeichnung "Lückenloses Audio" deaktiviert ist. Diese Eigenschaft ist standardmäßig auf den Wert VARIANT_FALSE festgelegt, wodurch die Verwendung der "lückenlosen" Aufzeichnung zwischen aufeinanderfolgenden Audiospuren deaktiviert wird. |
| IRawCDImageCreator::get_ExpectedTableOfContents Ruft das SCSI-Formular-Inhaltsverzeichnis für den resultierenden Datenträger ab. |
| IRawCDImageCreator::get_LastUsedUserSectorInImage Ruft die Anzahl der insgesamt verwendeten Sektoren auf den aktuellen Medien ab, einschließlich des Mehraufwands zwischen vorhandenen Spuren. |
| IRawCDImageCreator::get_MediaCatalogNumber Legt die Medienkatalognummer (Media Catalog Number, MCN) für den gesamten Audiodatenträger fest. |
| IRawCDImageCreator::get_NumberOfExistingTracks Ruft die Anzahl der vorhandenen Audiospuren auf den Medien ab. (IRawCDImageCreator.get_NumberOfExistingTracks) |
| IRawCDImageCreator::get_ResultingImageType Ruft den Wert ab, der den Typ der zu generierenden Bilddatei angibt. |
| IRawCDImageCreator::get_StartingTrackNumber Ruft die Startspurnummer ab. |
| IRawCDImageCreator::get_StartOfLeadout Ruft den Wert ab, der den LBA für den Start des Leadouts definiert. Diese Methode kann verwendet werden, um zu bestimmen, ob das Bild in ein Medienteil geschrieben werden kann, indem es mit dem LastPossibleStartOfLeadout für das Medium verglichen wird. |
| IRawCDImageCreator::get_StartOfLeadoutLimit Ruft den aktuellen StartOfLeadoutLimit-Eigenschaftswert ab. Dieser Wert gibt an, ob das resultierende Bild auf ein Medienteil mit einem StartOfLeadout passen muss, der größer als oder gleich dem LBA ist. |
| IRawCDImageCreator::get_TrackInfo Ruft eine indizierte Eigenschaft ab, die einen LONG-Wert mit einem Bereich von 1 bis 99 als Index annimmt, um zu bestimmen, welche Spur der Benutzer abfragt. Das zurückgegebene Objekt wird dann für die bestimmte pro Spur interessante Eigenschaft abgefragt/festgelegt. |
| IRawCDImageCreator::p ut_DisableGaplessAudio Legt den Wert fest, der angibt, ob die Aufzeichnung "Lückenloses Audio" deaktiviert ist. Diese Eigenschaft ist standardmäßig auf den Wert VARIANT_FALSE festgelegt, wodurch die Verwendung der "lückenlosen" Aufzeichnung zwischen aufeinanderfolgenden Audiospuren deaktiviert wird. |
| IRawCDImageCreator::p ut_MediaCatalogNumber Ruft die Medienkatalognummer (Media Catalog Number, MCN) für den gesamten Audiodatenträger ab. |
| IRawCDImageCreator::p ut_ResultingImageType Legt den Wert fest, der den Typ der generierten Imagedatei definiert. |
| IRawCDImageCreator::p ut_StartingTrackNumber Legt die Startspurnummer fest. |
| IRawCDImageCreator::p ut_StartOfLeadoutLimit Legt den Wert der StartOfLeadoutLimit-Eigenschaft fest. |
Hinweise
Mit dieser Schnittstelle erstellte Images können zur späteren Verwendung in persistenten Speicher geschrieben oder direkt an die IDiscFormat2RawCD-Schnittstelle zum Schreiben auf CD-Medien bereitgestellt werden.
DVD-Medien unterstützen diese Schreibweise nicht.
Diese Schnittstelle wird in Windows Server 2003 mit Service Pack 1 (SP1), Windows XP mit Service Pack 2 (SP2) und Windows Vista über das Windows Feature Pack for Storage unterstützt. Alle Features dieses Updatepakets werden in Windows 7 und Windows Server 2008 R2 nativ unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2.h |