IWiaDrvItem::GetFullItemName メソッド (wiamindr_lh.h)
IWiaDrvItem::GetFullItemName メソッドは、パス情報を含むアイテムの完全な名前を取得します。
構文
HRESULT GetFullItemName(
BSTR *__MIDL__IWiaDrvItem0002
);
パラメーター
__MIDL__IWiaDrvItem0002
pbstrFullItemName [out, optional]
項目の完全な名前を含む文字列のアドレスを受け取るメモリの場所を指します。
戻り値
メソッドが成功した場合、パス情報を含む項目の完全な名前へのポインターを pbstrFullItemName に格納し、 S_OKを返します。 メモリ不足のためにメソッドが文字列の割り当てに失敗した場合は、 E_OUTOFMEMORYを返します。 パラメーター pbstrFullItemName が無効な場合、メソッドは E_INVALIDARGを返します。 メソッドが別の理由で失敗した場合は、標準の COM エラー コードが返されます。
注釈
使用可能なメモリが十分にある場合、このメソッドは、パス情報を含む現在の項目の完全な名前を含む文字列を割り当てます。 メソッドは pbstrFullItemName 内の文字列へのポインターを返します。 ミニドライバーは 、SysFreeString 関数を呼び出して、文字列で使用されるメモリの割り当てを解除する必要があります。
pbstrFullItemName で返される名前は、ドライバー サービス ライブラリ関数 wiasCreateDrvItem によってアイテムが最初に作成されたときに、アイテムに関連付けられた名前です。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wiamindr_lh.h (Wiamindr.h を含む) |