IWMDMDeviceControl

IWMDMDeviceControl インターフェイスは、デバイス上の再生を制御するためのメソッドを提供します。

GetStatus メソッドは、デバイスの制御状態を取得します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれます (ただしこれらに限定されません)。

この呼び出しは、このインターフェイスのデバイス制御操作に固有の状態値を返します。制御状態からは、再生や録音など、デバイスの制御に関連する動作の状態についての情報が得られます。ただし、デバイスがデータをダウンロード中であるか、他の理由でアクセスされているかといった、デバイス全体の状態については分かりません。デバイス制御以外の理由でデバイスがビジー状態の場合はビジーを示すコードが返されるため、より詳細な情報を得るには IWMDMDeviceControl::GetStatus メソッドを呼び出す必要があります。

状態値として WMDM_STATUS_BUSY が返され、かつ状態値表の他の値がいずれも含まれていない場合は、このインターフェイスの Play、Record、Pause、Resume、Stop の各メソッドを呼び出そうとしてはいけません。

GetCapabilities メソッドは、デバイスがどの操作を実行できるかを判断するために、デバイスの機能を取得します。機能は、メディア デバイスがサポートするデバイス制御のメソッドを示します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれます (ただしこれらに限定されません)。

現時点では、機能を正しく報告するデバイスは多くありません。

例

次の C++ コードは、デバイスの機能を取得します。

// Examine the device capabilities.
// Use some of these to enable or disable the application's
// user interface elements.
CComQIPtr<IWMDMDeviceControl> pDeviceControl(pIWMDMDevice);
if (pDeviceControl != NULL)
{
    DWORD caps = 0;
    hr = pDeviceControl->GetCapabilities(&caps);
    if (caps & WMDM_DEVICECAP_CANPLAY)
    {
        // TODO: Display a message indicating that the media device can play MP3 audio.
    }
    if (caps & WMDM_DEVICECAP_CANSTREAMPLAY)
    {
        // TODO: Display a message that the device can play audio directly from the host computer.
    }
    if (caps & WMDM_DEVICECAP_CANRECORD)
    {
        // TODO: Display a message that the device can record audio.
    }
    if (caps & WMDM_DEVICECAP_CANSTREAMRECORD)
    {
        // TODO: Display a message that the media device can record 
        // streaming audio directly to the host computer.
    }
    if (caps & WMDM_DEVICECAP_CANPAUSE)
    {
        // TODO: Display a message that the device can pause during play or record operations.
    }
    if (caps & WMDM_DEVICECAP_CANRESUME)
    {
        // TODO: Display a message that the device can resume an operation that was paused.
    }
    if (caps & WMDM_DEVICECAP_CANSTOP)
    {
        // TODO: Display a message that the device can stop playing before the end of a file.
    }
    if (caps & WMDM_DEVICECAP_CANSEEK)
    {
        // TODO: Display a message that the device can seek to a position 
        // other than the beginning of the file.
    }
    if (caps & WMDM_DEVICECAP_HASSECURECLOCK)
    {
        // TODO: Display a message indicating that the device has a secure clock.
    }
}

Play メソッドは、現在のシーク位置から再生を開始します。IWMDMDeviceControl::Seek メソッドが呼び出されていない場合は、最初のファイルの先頭から再生が始まり、再生長は未定義になります。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれます (ただしこれらに限定されません)。

このメソッドは、デバイス再生 (メディア デバイスの記憶媒体上にあるオーディオ トラックの再生) と、ストリーミング オーディオ再生 (ユーザーのコンピューターからメディア デバイスへオーディオ データをストリーミングし、デバイス側で再生する) の両方を実行するために使用します。どちらの形式の再生が行われるかは、Seek メソッドによって決まります。

デバイスによっては、デバイス再生とストリーミング オーディオ再生のいずれかをサポートしていない場合があります。特定の種類の再生を開始する前に、GetCapabilities メソッドを呼び出す必要があります。サポートされていない再生を試みた場合、このメソッドは WMDM_E_NOTSUPPORTED を返します。

再生操作を実行する前に、あるオーディオ形式をメディア デバイスが再生できるかどうかを判断するには、GetFormatSupport メソッドを呼び出します。

Record メソッドは、デバイスの外部録音入力からの録音を、現在のシーク位置から開始します。事前に IWMDMDeviceControl::Seek メソッドを呼び出しておく必要があります。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれます (ただしこれらに限定されません)。

このメソッドは、デバイス録音 (メディア デバイスに保存するオーディオ トラックの録音) と、メディア デバイスからオーディオ データをストリーミングしてコンピューター上に録音する処理の両方を実行するために使用します。どちらの形式の録音が行われるかは、Seek メソッドによって決まります。

デバイスによっては、いずれの種類の録音もサポートしていない場合があります。録音を開始する前に GetCapabilities メソッドを呼び出す必要があります。サポートされていない種類の録音を試みた場合、このメソッドは WMDM_E_NOTSUPPORTED を返します。

pFormat パラメーターに引数を指定することで、録音に使用するオーディオ形式を指定できます。デバイスがサポートする形式を調べるには、GetFormatSupport を参照してください。pFormat パラメーターに NULL を設定した場合、デバイスは既定の形式でオーディオ データを録音します。

デバイス録音を使用する場合は、録音操作の完了後に記憶媒体の内容を列挙して、新しいオブジェクトを見つける必要があります。

Pause メソッドは、現在の再生または録音セッションを、コンテンツ内の現在位置で一時停止します。(IWMDMDeviceControl.Pause)

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれます (ただしこれらに限定されません)。

現在の再生または録音セッションが一時停止され、現在のファイル位置が保存されます。その後 Resume メソッドを呼び出すと、保存されたファイル位置から再生または録音の操作が再開されます。

Resume メソッドは、Pause の呼び出し時に保存されたファイル位置から、現在の再生または録音操作を再開します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれます (ただしこれらに限定されません)。

Stop メソッドは、現在の録音または再生の操作を停止します。

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれます (ただしこれらに限定されません)。

Seek メソッドは、Play メソッドまたは Record メソッドが開始位置として使用する位置へシークします。(IWMDMDeviceControl.Seek)

このメソッドは HRESULT を返します。返される可能性のある値には、次の表に示すものが含まれます (ただしこれらに限定されません)。

シーク位置は、デバイスの記憶媒体上の場所を指す IWMDMStorage インターフェイス、またはストリーミング オーディオをサポートするように実装された IWMDMOperation インターフェイスを渡すことで指定します。また、指定したインターフェイスが指すオブジェクト内の特定の位置を示すために、IWMDMObjectInfo インターフェイスを渡すこともできます。

デバイス再生では、Play の前に Seek を呼び出さなかった場合、メディア デバイスの最初の記憶媒体にある最初のオーディオ トラックから再生が始まります。

デバイス録音では、Record の前に Seek を呼び出さなかった場合、録音操作は失敗します。録音の長さを制限するには、Seek の呼び出しから戻った後に IWMDMObjectInfo::SetPlayLength メソッドを呼び出します。