IAudioSessionControl::GetIconPath メソッド (audiopolicy.h)

  • [アーティクル]

GetIconPath メソッドは、オーディオ セッションの表示アイコンのパスを取得します。

構文

HRESULT GetIconPath(
  [out] LPWSTR *pRetVal
);

パラメーター

[out] pRetVal

アイコンを含む.ico、.dll、または .exe ファイルの完全修飾パスを指定する、null で終わるワイド文字列のアドレスをメソッドが書き込むポインター変数へのポインター。 メソッドは、文字列のストレージを割り当てます。 呼び出し元は、 CoTaskMemFree 関数を呼び出すことによって、不要になったストレージを解放する役割を担います。 アイコン パスと CoTaskMemFree の詳細については、Windows SDKドキュメントを参照してください。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_POINTER
 パラメーター pRetVal は NULL です。
E_OUTOFMEMORY
 メモリが不足しています。
AUDCLNT_E_DEVICE_INVALIDATED
 オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows オーディオ サービスが実行されていません。

注釈

クライアントが IAudioSessionControl::SetIconPath を呼び出して表示アイコンを設定していない場合、文字列は空になります。 使用できるクライアント指定のアイコンがない場合、Sndvol プログラムは、クライアントのアプリケーション ウィンドウのアイコンを使用して、オーディオ セッションのボリューム コントロールにラベルを付けます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー audiopolicy.h

こちらもご覧ください

IAudioSessionControl インターフェイス

IAudioSessionControl::SetIconPath