Partager via

Méthode IDiscRecorder2 ::EnableMcn (imapi2.h)

  • Article

Active la notification de changement multimédia (MCN) pour l’appareil.

Syntaxe

HRESULT EnableMcn();

Valeur de retour

S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour Description
E_FAIL
 Défaillance non spécifiée.

Valeur : 0x80004005
E_OUTOFMEMORY
 Impossible d’allouer la mémoire requise.

Valeur : 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT
 L’appareil n’a pas pu accepter la commande dans le délai d’expiration. Cela peut être dû au fait que l’appareil a entré un état incohérent ou que la valeur du délai d’expiration de la commande doit être augmentée.

Valeur : 0xC0AA020D
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
 Le handle spécifié n’est pas valide.

Valeur : 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
 La ressource réseau ou le périphérique spécifié n’est plus disponible.

Valeur : 55
E_IMAPI_RECORDER_LOCKED
 L’appareil associé à cet enregistreur lors de la dernière opération a été exclusivement verrouillé, ce qui a entraîné l’échec de cette opération.

Valeur : 0xC0AA0210

Remarques

MCN est la méthode du pilote de périphérique de CD-ROM pour détecter les changements de média et d’état dans le périphérique CD-ROM. Par exemple, lorsque vous modifiez le média dans un périphérique CD-ROM, un message MCN est envoyé pour déclencher des fonctionnalités multimédias, telles que la lecture automatique. MCN est activé par défaut. Appelez cette méthode pour activer les notifications lorsque les notifications ont été désactivées à l’aide d’IDiscRecorder2 ::D isableMcn.

Notez que DisableMcn incrémente un nombre de références chaque fois qu’il est appelé. La méthode EnableMcn décrémente le nombre. L’appareil est activé lorsque le nombre de références est égal à zéro.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête imapi2.h

Voir aussi

IDiscRecorder2

IDiscRecorder2 ::D isableMcn