IDiscRecorder2::D isableMcn メソッド (imapi2.h)
デバイスのメディア変更通知 (MCN) を無効にします。
構文
HRESULT DisableMcn();
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
| リターン コード | 説明 |
|---|---|
|
不特定のエラー。
値: 0x80004005 |
|
必要なメモリを割り当てませんでした。
値: 0x8007000E |
|
デバイスは、タイムアウト期間内にコマンドを受け入れませんでした。 これは、デバイスが不整合な状態になったか、コマンドのタイムアウト値を増やす必要がある場合があります。
値: 0xC0AA020D |
|
指定されたハンドルが無効です。
値: 6 |
|
指定したネットワーク リソースまたはデバイスが使用できなくなりました。
値: 55 |
|
前回の操作中にこのレコーダーに関連付けられているデバイスが排他的にロックされているため、この操作は失敗しました。
値: 0xC0AA0210 |
解説
MCN は CD-ROM デバイス ドライバーの CD-ROM デバイス内のメディアの変化と状態の変化を検出する方法です。 たとえば、CD-ROM デバイスでメディアを変更すると、MCN メッセージが送信され、自動再生などのメディア機能がトリガーされます。 機能を無効にするには、このメソッドを呼び出します。
通知を有効にするには、 IDiscRecorder2::EnableMcn メソッドを呼び出します。 アプリケーションが予期せずクラッシュまたは終了した場合、MCN はドライバーによって自動的に再び有効になります。
DisableMcn は、呼び出されるたびに参照カウントをインクリメントします。 EnableMcn メソッドは、カウントをデクリメントします。 デバイスは、参照カウントが 0 の場合に有効になります。
要件
| サポートされている最小のクライアント | Windows Vista、SP2 を使用した Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imapi2.h |