IDiscMaster::GetActiveDiscRecorder-Methode (imapi.h)
Ruft einen Schnittstellenzeiger auf den aktiven Datenträgerrecorder ab. Der aktive DiscRecorder ist der Rekorder, bei dem beim Aufruf von RecordDisc ein Brennen auftritt.
Syntax
HRESULT GetActiveDiscRecorder(
[out] IDiscRecorder **ppRecorder
);
Parameter
[out] ppRecorder
Zeiger auf die IDiscRecorder-Schnittstelle des derzeit ausgewählten Disc Recorders.
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
Es gibt keinen standardmäßigen aktiven Datenträgerrekorder. Eine Anwendung, die diese Methode verwendet, muss ausdrücklich sowohl ein aktives Masteringformat als auch einen aktiven DiscRecorder auswählen, bevor ein Brennen initiiert wird.
Hinweis
Der aktive Datenträgerrekorder kann ungültig gemacht werden, indem das Gerät entfernt oder das aktive Datenträgermasterformat geändert wird. Beispielsweise kann ein USB CD-R-Gerät vom Computer getrennt werden, während die Anwendung noch ausgeführt wird (die Anwendung wird durch einen Aufruf von IDiscMasterProgressEvents::NotifyPnPActivity zu dieser Bedingung gewarnt). In beiden Fällen müssen Sie einen neuen aktiven Datenträgerrekorder auswä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 |