IDiscMaster2

コンピューターにインストールされている CD および DVD デバイスを列挙するには、このインターフェイスを使用します。

スクリプトで MsftDiscMaster2 オブジェクトを作成するには、CreateObject を呼び出す際のプログラム識別子として IMAPI2.MsftDiscMaster2 を使用します。

デバイスがコンピューターに追加またはコンピューターから削除されたときに通知を受け取るには、DDiscMaster2Events インターフェイスを実装します。

コンピューターにインストールされている CD および DVD デバイスの一覧を取得します。

要求された数の要素 (celt) が正常に返された場合、または返された項目数 (pceltFetched) が要求された要素数より少ない場合に S_OK が返されます。celt および pceltFetched パラメーターは IEnumVariant で定義されています。

実装によってはその他の成功コードが返されることもあります。次のエラーコードは操作の失敗時に一般的に返されるものですが、返される可能性のある値はこれらだけではありません:

この列挙は呼び出し時点でのコンピューター上のデバイスのスナップショットであり、その後に追加または削除されたデバイスは反映されません。デバイスがコンピューターに追加またはコンピューターから削除されたときに通知を受け取るには、DDiscMaster2Events インターフェイスを実装します。

単一の識別子を取得するには、IDiscMaster2::get_Item プロパティを参照してください。

デバイス識別子は、Windows プラグ アンド プレイが認識する特定のデバイスに対して一意かつ不変であることが保証されています。この識別子は、ユーザーの既定の書き込みドライブを保存するためのキー値として使用できるほか、高度なアプリケーションではデバイス固有の静的な情報 (VendorID や ProductID など) をキャッシュする目的でも使用できます。

指定したディスクデバイスの一意の識別子を取得します。

成功した場合は S_OK が返されますが、実装によってはその他の成功コードが返されることもあります。次のエラーコードは操作の失敗時に一般的に返されるものですが、返される可能性のある値はこれらだけではありません:

すべての識別子を列挙するには、IDiscMaster2::get__NewEnum メソッドを呼び出します。

次のサンプルは、IDiscMaster2 オブジェクトを最初に作成した後に追加または削除されたドライブを正確に把握するために、光学ドライブを再列挙する方法を示しています。これは IDiscMaster2::get_Item メソッドと IDiscMaster2::get_Count メソッドによって実現します:

#include <windows.h>
#include <tchar.h>
#include <imapi2.h>
#include <objbase.h>
#include <stdio.h>

#pragma comment(lib, "ole32.lib")
#pragma comment(lib, "user32.lib")

int __cdecl _tmain(int argc, TCHAR* argv[])   
{   
    BSTR           bstrDeviceName;   
    HRESULT        hr = S_OK;   
    BOOL           bComInitialised;       
    IDiscMaster2*  discMaster;   
    UINT           iCounter = 0; 
    LONG           lValue = 0; 

    bComInitialised = SUCCEEDED(CoInitializeEx(0, COINIT_MULTITHREADED));

    // Create an object of IDiscMaster2  
    if (SUCCEEDED(hr)){
        CoCreateInstance(
            CLSID_MsftDiscMaster2,
            NULL, CLSCTX_ALL,
            IID_PPV_ARGS(&discMaster)
        );   

        if(FAILED(hr)){
            _tprintf(TEXT("\nUnsuccessful in creating an instance of CLSID_MsftDiscMaster2.\n\nError returned: 0x%x\n"), hr);
            return 0;
        }
    }
    //
    // Loop twice and get the optical drives attached to the system,
    // first time just get the current configuration and second time 
    // prompt the user to change the configuration and then get the 
    // altered configuration.   
    //
    do{
        // Get the number of drives 
        if (SUCCEEDED(hr)){
            hr = discMaster->get_Count(&lValue);
            if (SUCCEEDED(hr)){
                _tprintf(TEXT("\nTotal number of drives = %d\n"), lValue);
            }
        }

        // Print all the optical drives attached to the system 
        if (SUCCEEDED(hr)){
            for(LONG iCount = 0; iCount < lValue; iCount++) {
                hr = discMaster->get_Item(iCount, &bstrDeviceName);
                _tprintf(TEXT("\nUnique identifier of the disc device associated with index %d is: %s\n"), iCount, bstrDeviceName);
            }            
        }

        // Prompt the user to unhook or add drives
        if (iCounter < 1){
            MessageBox(NULL,TEXT("Please un-hook or add drives and hit OK"), TEXT("Manual Action"), MB_OK);
            _tprintf(TEXT("\nGetting the altered configuration ... \n"));
        }
        iCounter++;
    }while(iCounter < 2);

    discMaster->Release();
    CoUninitialize();   
    bComInitialised = FALSE;   

    return 0;

コンピューターにインストールされている CD および DVD ディスクデバイスの数を取得します。

成功した場合は S_OK が返されますが、実装によってはその他の成功コードが返されることもあります。次のエラーコードは操作の失敗時に一般的に返されるものですが、返される可能性のある値はこれらだけではありません:

環境に 1 つ以上の光学デバイスが含まれており、かつ実行コンテキストがそれらのデバイスにアクセスする権限を持っているかどうかを示す値を取得します。

成功した場合は S_OK が返されますが、実装によってはその他の成功コードが返されることもあります。次のエラーコードは操作の失敗時に一般的に返されるものですが、返される可能性のある値はこれらだけではありません:

このメソッドは IDiscMaster2 内のすべての文字列をループ処理し、各文字列を使用して DiscRecorder2 オブジェクトの初期化を試みます。システム上のいずれかのレコーダーで初期化に成功した場合、このメソッドは TRUE を返します。

環境には少なくとも 1 つのタイプ 5 光学デバイスが含まれている必要があります。