IAudioSessionControl::GetIconPath メソッド (audiopolicy.h)
GetIconPath メソッドは、オーディオ セッションの表示アイコンのパスを取得します。
構文
HRESULT GetIconPath(
[out] LPWSTR *pRetVal
);
パラメーター
[out] pRetVal
アイコンを含む.ico、.dll、または .exe ファイルの完全修飾パスを指定する、null で終わるワイド文字列のアドレスをメソッドが書き込むポインター変数へのポインター。 メソッドは、文字列のストレージを割り当てます。 呼び出し元は、 CoTaskMemFree 関数を呼び出すことによって、不要になったストレージを解放する役割を担います。 アイコン パスと CoTaskMemFree の詳細については、Windows SDKドキュメントを参照してください。
戻り値
メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
パラメーター pRetVal は NULL です。 |
|
メモリが不足しています。 |
|
オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。 |
|
Windows オーディオ サービスが実行されていません。 |
注釈
クライアントが IAudioSessionControl::SetIconPath を呼び出して表示アイコンを設定していない場合、文字列は空になります。 使用できるクライアント指定のアイコンがない場合、Sndvol プログラムは、クライアントのアプリケーション ウィンドウのアイコンを使用して、オーディオ セッションのボリューム コントロールにラベルを付けます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | audiopolicy.h |