IPinName::GetPinName メソッド (portcls.h)

[アーティクル]
03/05/2024

メソッドは 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。