IDiscRecorder-Schnittstelle (imapi.h)
Die IDiscRecorder-Schnittstelle ermöglicht den Zugriff auf ein einzelnes Discrecordergerät mit der Bezeichnung aktive Discrecorder. Ein IMAPI-Objekt wie MSDiscMasterObj verwaltet einen aktiven Discrecorder.
Ein IDiscRecorder-Objekt stellt ein einzelnes Hardwaregerät dar, es kann jedoch mehrere Instanzen von IDiscRecorder geben, die alle auf dasselbe Hardwaregerät verweisen. Verwenden Sie in diesem Fall OpenExclusive , um auf dieses Gerät zuzugreifen.
Vererbung
Die IDiscRecorder-Schnittstelle erbt von der IUnknown-Schnittstelle . IDiscRecorder verfügt auch über folgende Membertypen:
Methoden
Die IDiscRecorder-Schnittstelle verfügt über diese Methoden.
| IDiscRecorder::Close Gibt exklusiven Zugriff auf einen Discrecorder frei. Dadurch wird der Dateisystemzugriff auf das Laufwerk wiederhergestellt. |
| IDiscRecorder::Eject Entsperrt und wirft nach Möglichkeit das Tray des Discrecorders aus. |
| IDiscRecorder::Erase Versucht, die CD-RW-Medien zu löschen, wenn es sich um einen CD-RW-Datenträgerrekorder handelt. Sowohl vollständige als auch schnelle Löschungen werden unterstützt. |
| IDiscRecorder::GetBasePnPID Ruft eine PnP-Basiszeichenfolge ab, die verwendet werden kann, um eine bestimmte Geräteklasse durch Make und Modell konsistent zu identifizieren. Die Zeichenfolge kann von Anwendungen verwendet werden, um ihr Verhalten entsprechend dem jeweiligen Aufzeichnungstyp anzupassen. |
| IDiscRecorder::GetDisplayNames Ruft einen formatierten Namen für den Rekorder ab, der angezeigt werden kann. Der Name besteht aus dem Hersteller und dem Produktbezeichner des Geräts. |
| IDiscRecorder::GetPath Ruft einen Pfad zum Gerät innerhalb des Betriebssystems ab. Dieser Pfad sollte in Verbindung mit dem Anzeigenamen verwendet werden, um einen verfügbaren Discrecorder vollständig zu identifizieren. |
| IDiscRecorder::GetRecorderGUID Ruft die GUID des physischen Datenträgerrecorders ab, der derzeit dem Recorder-Objekt zugeordnet ist. |
| IDiscRecorder::GetRecorderProperties Ruft einen Zeiger auf eine IPropertyStorage-Schnittstelle ab. |
| IDiscRecorder::GetRecorderState Ruft den Datenträgerrekorderstatus ab. |
| IDiscRecorder::GetRecorderType Bestimmt, ob es sich bei dem Datenträgerrekorder um ein Gerät vom Typ CD-R oder CD-RW handelt. Dies gibt nicht den Typ der Medien an, die derzeit in das Gerät eingefügt werden. |
| IDiscRecorder::OpenExclusive Öffnet einen DiscRecorder für den exklusiven Zugriff. |
| IDiscRecorder::QueryMediaInfo Ruft Informationen zu den aktuell eingebundenen Medien ab, z. B. die Gesamtzahl der auf dem Medium verwendeten Blöcke. |
| IDiscRecorder::QueryMediaType Erkennt den Typ der Medien, die derzeit im Rekorder eingefügt werden, falls vorhanden. |
| IDiscRecorder::SetRecorderProperties Akzeptiert einen IPropertyStorage-Zeiger für ein Objekt mit allen Eigenschaften, die die Anwendung ändern möchte. Sparseeinstellungen werden unterstützt. |
Hinweise
Alle IDiscRecorder-Schnittstellen können für ein IDiscRecorder-Objekt verwendet werden, auch wenn der Discrecorder nicht der aktive Discrecorder ist. Der IMAPI-Client muss nicht zuerst IDiscMaster::SetActiveDiscRecorder aufrufen.
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 |