IPinName::GetPinName メソッド (portcls.h)
GetPinName メソッドは、オーディオ エンドポイントのフレンドリ名を取得します。 ピンの詳細については、「フィルター、ピン、およびノードのプロパティのを参照してください。
構文
NTSTATUS GetPinName(
[in] PIRP Irp,
[in] PKSP_PIN Pin,
[out] PVOID Data
);
パラメーター
[in] Irp
I/O 要求パケット (IRP) 構造体へのポインターを指定します。 IRP の詳細については、IRP と I/O 要求パケット を参照してください。
[in] Pin
基になるカーネル ストリーミング (KS) ピンへのポインターを指定します。
[out] Data
GetPinName メソッドのデータを保持するバッファーへのポインターを指定します。
戻り値
GetPinName メソッドは、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切なエラー コードが返されます。
備考
クライアントがエンドポイントの現在のピン名を必要とするが、ミニポート ドライバーが GetPinName メソッドをサポートしていないと判断した場合、クライアントはトポロジ ブリッジ ピンのフレンドリ名を使用します。 ピン留めカテゴリとフレンドリ名の詳細については、「オーディオ エンドポイント デバイスの カテゴリ プロパティの とフレンドリ名をピン留めする」を参照してください。
詳細については、以下を参照してください。
注 Windows 7 では、ユーザー モードのオーディオ スタックは Speakers エンドポイント名のカスタマイズをサポートしていません。 そのため、Windows 7 では、
GetPinName メソッドは Speakers フレンドリ名を持たないエンドポイントでのみ機能します。 次の一覧は、Speakers フレンドリ名が割り当てられている KS ノードの種類のカテゴリを示しています。- KSNODETYPE_SPEAKER
- KSNODETYPE_DESKTOP_SPEAKER
- KSNODETYPE_ROOM_SPEAKER
- KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | portcls.h (Portcls.h を含む) |
| IRQL | PASSIVE_LEVEL。 |
関連項目
IPinName を する
ファクトリ をピン留めする