IDiscMaster::EnumDiscRecorders-Methode (imapi.h)
Ruft einen Enumerator für alle Datenträgerrecorder ab, die vom aktiven Datenträger master-Format unterstützt werden.
Syntax
HRESULT EnumDiscRecorders(
[out] IEnumDiscRecorders **ppEnum
);
Parameter
[out] ppEnum
Adresse eines Zeigers auf den IEnumDiscRecorders-Enumerator .
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
IEnumDiscRecorders ist ein COM-Standardenumerator, wie in IEnumXXXX dokumentiert. Jeder Aufruf von Next gibt ein Array von Zeigern auf IDiscRecorder zurück. Jede Aufzeichnungsschnittstelle stellt einen einzelnen verfügbaren Rekorder dar, der bereits einem zugrunde liegenden physischen Datenträgerrecorder zugeordnet ist.
Die Liste der verfügbaren Aufzeichnungen kann sich aufgrund von Plug-and-Play-An- oder Abreisen oder einem Aufruf von SetActiveDiscMasterFormat ändern. Eine Anwendung wird über diese Änderungen benachrichtigt, wenn sie einen Aufruf von IDiscMasterProgressEvents::NotifyPnPActivity empfängt. Wenn eine Änderung auftritt, sollte die Anwendung diese Methode erneut aufrufen, um einen neuen Enumerator abzurufen, da jeder Enumerator eine Momentaufnahme der Zum Zeitpunkt der Enumeration unterstützten Geräte enthält.
Wenn ein Gerät entfernt wird, müssen der Zeiger und die IDiscRecorder-Schnittstelle gültig bleiben, auch wenn das zugrunde liegende physische Gerät fehlt. In diesem Fall können Vorgänge für einen IDiscRecorder oder eine Anforderung zum Aufzeichnen eines Datenträgers IMAPI_E_DEVICE_NOTPRESENT zurückgeben.
Die MaxWriteSpeed-Eigenschaft wird aktualisiert, wenn diese Methode aufgerufen wird. Die Standardeinstellung ist die höchste verfügbare Schreibgeschwindigkeit.
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 |