Freigeben über


IDiscRecorder2::D isableMcn-Methode (imapi2.h)

Deaktiviert die Medienänderungsbenachrichtigung (Media Change Notification, MCN) für das Gerät.

Syntax

HRESULT DisableMcn();

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
E_FAIL
Unspezifizierter Fehler.

Wert: 0x80004005

E_OUTOFMEMORY
Fehler beim Zuweisen des erforderlichen Arbeitsspeichers.

Wert: 0x8007000E

E_IMAPI_RECORDER_COMMAND_TIMEOUT
Das Gerät konnte den Befehl innerhalb des Timeoutzeitraums nicht annehmen. Dies kann dadurch verursacht werden, dass das Gerät einen inkonsistenten Zustand eingegeben hat, oder der Timeoutwert für den Befehl muss möglicherweise erhöht werden.

Wert: 0xC0AA020D

HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
Das angegebene Handle ist ungültig.

Wert: 6

HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
Die angegebene Netzwerkressource oder das angegebene Gerät ist nicht mehr verfügbar.

Wert: 55

E_IMAPI_RECORDER_LOCKED
Das diesem Rekorder während des letzten Vorgangs zugeordnete Gerät wurde ausschließlich gesperrt, sodass dieser Vorgang nicht erfolgreich war.

Wert: 0xC0AA0210

Hinweise

MCN ist die Methode des CD-ROM-Gerätetreibers, um Medienänderungen und Zustandsänderungen auf dem CD-ROM-Gerät zu erkennen. Wenn Sie beispielsweise die Medien in einem CD-ROM-Gerät ändern, wird eine MCN-Nachricht gesendet, um Medienfeatures wie die automatische Wiedergabe auszulösen. Rufen Sie diese Methode auf, um die Features zu deaktivieren.

Um Benachrichtigungen zu aktivieren, rufen Sie die IDiscRecorder2::EnableMcn-Methode auf. Wenn die Anwendung unerwartet abstürzt oder geschlossen wird, wird MCN vom Treiber automatisch wieder aktiviert.

Beachten Sie, dass DisableMcn bei jedem Aufruf eine Verweisanzahl erhöht. Die EnableMcn-Methode erhöht die Anzahl. Das Gerät ist aktiviert, wenn die Verweisanzahl 0 ist.

Anforderungen

   
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

Weitere Informationen

IDiscRecorder2

IDiscRecorder2::EnableMcn