IMDSPDevice::GetName メソッド (mswmdm.h)
GetName メソッドは、デバイスの名前を取得します。
構文
HRESULT GetName(
[out] LPWSTR pwszName,
[in] UINT nMaxChars
);
パラメーター
[out] pwszName
デバイス名の文字列を受け取る 16 ビット Unicode 文字の配列へのポインター。
[in] nMaxChars
文字列にコピーする最大文字数。
戻り値
このメソッドは HRESULT を返します。 Windows Media デバイス マネージャーのすべてのインターフェイス メソッドは、次のいずれかのエラー コード クラスを返すことができます。
- 標準 COM エラー コード
- HRESULT 値に変換された Windows エラー コード
- Windows Media デバイス マネージャーエラー コード
注釈
LPWSTR 文字列型は 16 ビット Unicode 文字列であり、バイト サイズの文字を受け入れません。 バイト サイズの文字 (LPCSTR) の文字列を LPWSTR 文字列に変換するには、Microsoft Windows ドキュメントで説明されているように MultiByteToWideChar 関数を使用します。
デバイス名には末尾のスペースを含めることはできません。
このメソッドを実装する必要があります。 WMDM_E_NOTSUPPORTEDまたはE_NOTIMPLを返してはなりません。 詳細については、「 必須インターフェイスとオプション インターフェイス」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | mswmdm.h |
Library | Mssachlp.lib |