IDiscRecorder2::DisableMcn method (imapi2.h)
Disables Media Change Notification (MCN) for the device.
Syntax
HRESULT DisableMcn();
Return value
S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:
| Return code | Description |
|---|---|
|
Unspecified failure.
Value: 0x80004005 |
|
Failed to allocate the required memory.
Value: 0x8007000E |
|
The device failed to accept the command within the timeout period. This may be caused by the device having entered an inconsistent state, or the timeout value for the command may need to be increased.
Value: 0xC0AA020D |
|
The specified handle is invalid.
Value: 6 |
|
The specified network resource or device is no longer available.
Value: 55 |
|
The device associated with this recorder during the last operation has been exclusively locked, causing this operation to failed.
Value: 0xC0AA0210 |
Remarks
MCN is the CD-ROM device driver's method of detecting media change and state changes in the CD-ROM device. For example, when you change the media in a CD-ROM device, a MCN message is sent to trigger media features, such as Autoplay. To disable the features, call this method.
To enable notifications, call the IDiscRecorder2::EnableMcn method. If the application crashes or closes unexpectedly, then MCN is automatically re-enabled by the driver.
Note that DisableMcn increments a reference count each time it is called. The EnableMcn method decrements the count. The device is enabled when the reference count is zero.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista, Windows XP with SP2 [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | imapi2.h |