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
サポートしていないと判断した場合、クライアントはトポロジ ブリッジ ピンのフレンドリ名を使用します。 ピン カテゴリとフレンドリ名の詳細については、「Pin Category プロパティ 」および「 オーディオ エンドポイント デバイスのフレンドリ名」を参照してください。
詳細情報
メモ 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 で使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | portcls.h (Portcls.h を含む) |
IRQL | PASSIVE_LEVEL。 |