IMFAudioPolicy

ストリーミングオーディオレンダラー (SAR) に関連付けられたオーディオセッションを構成します。

オーディオセッションをセッションのグループに割り当てます。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

2 つ以上のオーディオセッションが同じグループを共有する場合、Windows の音量コントロールはグループ全体に対して 1 つのスライダーコントロールを表示します。それ以外の場合は、セッションごとにスライダーを表示します。詳細については、コアオーディオ API ドキュメントの IAudioSessionControl::SetGroupingParam を参照してください。

このオーディオセッションが属するセッションのグループを取得します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

2 つ以上のオーディオセッションが同じグループを共有する場合、Windows の音量コントロールはグループ全体に対して 1 つのスライダーコントロールを表示します。それ以外の場合は、セッションごとにスライダーを表示します。詳細については、コアオーディオ API ドキュメントの IAudioSessionControl::SetGroupingParam を参照してください。

オーディオセッションの表示名を設定します。Windows の音量コントロールはこの名前を表示します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

アプリケーションが表示名を設定しない場合、Windows が表示名を作成します。

オーディオセッションの表示名を取得します。Windows の音量コントロールはこの名前を表示します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

アプリケーションが表示名を設定しない場合、Windows が表示名を作成します。

オーディオセッションのアイコンリソースを設定します。Windows の音量コントロールはこのアイコンを表示します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

アイコンパスの形式は "path,index" または "path,-id" です。ここで、path は DLL、実行可能ファイル、またはアイコンファイルへの完全修飾パス、index はファイル内のアイコンの 0 から始まるインデックス、id はリソース識別子です。リソース識別子は、インデックスと区別するためにマイナス記号 (-) が前に付くことに注意してください。パスには "%windir%" などの環境変数を含めることができます。詳細については、Windows SDK の IAudioSessionControl::SetIconPath を参照してください。

例

次の例では、アプリケーションの実行可能ファイル内のアイコンに対して、リソース識別子を使用してアイコンを設定します。

HRESULT SetIcon(IMFMediaSession *pSession, int nID)
{
    IMFAudioPolicy *pPolicy = NULL;

    const DWORD CCH_ICON_PATH = MAX_PATH + 16;
    WCHAR szFileName[MAX_PATH];
    WCHAR szIconPath[CCH_ICON_PATH];

    HRESULT hr = S_OK;

    DWORD result = GetModuleFileNameW(NULL, szFileName, MAX_PATH);

    // Note: GetModuleFileName can return a truncated string without a 
    // NULL terminator. If so, the function succeeds but sets the last 
    // error to ERROR_INSUFFICIENT_BUFFER.
    if ((result == 0) || (GetLastError() ==  ERROR_INSUFFICIENT_BUFFER))
    {
        hr = E_FAIL;
        goto done;
    }

    hr = StringCchPrintfW(szIconPath, CCH_ICON_PATH, 
                 L"%s,-%d", szFileName, nID);

    if (FAILED(hr))
    {
        goto done;
    }

    hr = MFGetService(
        pSession, 
        MR_AUDIO_POLICY_SERVICE, 
        IID_PPV_ARGS(&pPolicy)
        );

    if (FAILED(hr))
    {
        goto done;
    }

    hr = pPolicy->SetIconPath(szIconPath);
    if (FAILED(hr))
    {
        goto done;
    }

done:
    SafeRelease(&pPolicy);
    return hr;
}

オーディオセッションのアイコンリソースを取得します。Windows の音量コントロールはこのアイコンを表示します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

アプリケーションがアイコンパスを設定しなかった場合、このメソッドは空の文字列 ("") を返します。

詳細については、コアオーディオ API ドキュメントの IAudioSessionControl::GetIconPath を参照してください。