IDiscMaster::SetActiveDiscMasterFormat-Methode (imapi.h)
Legt das aktuell aktive Format des Datenträgerrecorders fest. Das aktive Format gibt sowohl die Struktur des Inhalts der mehrstufigen Bilddatei (Audio/Daten) als auch die COM-Schnittstelle an, die zum Bearbeiten dieses mehrstufigen Bilds verwendet werden muss.
Syntax
HRESULT SetActiveDiscMasterFormat(
[in] REFIID riid,
[out] void **ppUnk
);
Parameter
[in] riid
IID des derzeit aktiven Formats.
[out] ppUnk
Zeiger auf die COM-Schnittstelle für das neue Datenträgerformat.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
Hinweise
Ein erfolgreicher Aufruf dieser Methode löscht den Inhalt des aktuell bereitgestellten Bilds. Darüber hinaus kann die Liste der unterstützten Datenträgerrecorder geändert werden. Dies liegt daran, dass nicht alle Aufzeichnungen alle Formate unterstützen. Änderungen an der Aufzeichnungsliste werden mit IDiscMasterProgressEvents::NotifyPnPActivity angekündigt. Wenn der aktuell ausgewählte Recorder kein Mitglied der neuen Gruppe unterstützter Geräte ist, gibt es keinen aktiven Recorder mehr (ähnlich dem Zustand nach dem ersten Aufruf von Open). In diesem Fall muss die Anwendung einen neuen aktiven Rekorder auswählen, bevor ein Brennen initiiert wird.
MSDiscMasterObj unterstützt nur die folgenden IIDs: IID_IRedbookDiscMaster (IRedbookDiscMaster) und IID_IJolietDiscMaster (IJolietDiscMaster). Wenn kein Format festgelegt ist, ist der Standardwert das Joliet-Format. Es liegt in der Verantwortung jeder Anwendung, ein Format master durch die Verwendung von EnumDiscMasterFormats und dieser Methode auszuwählen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi.h |
| Bibliothek | Uuid.lib |
| DLL | Actxprxy.dll |