PcRegisterPhysicalConnectionToExternal 関数 (portcls.h)

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

PcRegisterPhysicalConnectionToExternal 関数は、オーディオアダプターフィルターから外部オーディオアダプターフィルターへの物理接続を登録します。

構文

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionToExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNKNOWN        FromUnknown,
  [in] ULONG           FromPin,
  [in] PUNICODE_STRING ToString,
  [in] ULONG           ToPin
);

パラメーター

[in] DeviceObject

デバイスのデバイスオブジェクトへのポインター。これは、 DEVICE_OBJECT型のシステム構造です。

[in] FromUnknown

ポートドライバーオブジェクトの IPort インターフェイスへのポインター。 FromUnknown に関連付けられているポートドライバーオブジェクトは、接続のデータソース (出力) ピンを提供するサブデバイスにバインドされます。

[in] FromPin

ピン ID を指定します。このパラメーターは、 FromUnknown インターフェイスに関連付けられているフィルターのソース (出力) ピンを識別します。

[in] ToString

接続のシンクピンを提供する外部フィルターのシンボリックリンク名を含む null で終わる Unicode 文字列へのポインター。

[in] ToPin

ピン ID を指定します。このパラメーターは、 ToString という名前の外部フィルターのシンク (入力) ピンを識別します。

戻り値

PcRegisterPhysicalConnectionToExternal は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。それ以外の場合は、適切なエラーコードを返します。

注釈

アダプタードライバーは 、PcRegisterPhysicalConnectionToExternal を呼び出して、PortCls システムドライバーに物理接続を登録します。 PortCls は、この情報を格納して、その後、ポートドライバーが情報を使用して KSPROPERTY_PIN_PHYSICALCONNECTION プロパティ要求に応答できるようにします。

この関数は、異なるアダプタードライバーによって制御される 2 つのオーディオアダプター間のトポロジリンクを指定する場合に便利です。関数は、ローカルオーディオアダプターのサブデバイスを表すフィルターオブジェクトと、外部アダプターのサブデバイスを表すフィルターオブジェクトとの間の物理的な接続を登録します。

ToString パラメーターは、外部アダプタードライバーによって公開されるサブデバイスへのシンボリックリンクです。

外部物理接続を登録するために必要な情報は、2 つのドライバーに提供する必要があります。これは、2 つのデバイスの初期調整インストール中に行うか、両方のデバイスの構成の変更を調整するユーザーモード構成プログラムによって動的に行うことができます。

アダプタードライバーは、IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal メソッドを呼び出して、 PcRegisterPhysicalConnectionToExternal の以前の呼び出しによって登録された物理接続の登録を削除できます。詳細については、「ダイナミックオーディオサブデバイス」を参照してください。

要件

要件	値
サポートされている最小のクライアント	PortCls システムドライバーは、Microsoft Windows 98/Me および Windows 2000 以降のオペレーティングシステムで PcRegisterPhysicalConnectionToExternal 関数を実装します。
対象プラットフォーム	ユニバーサル
Header	portcls.h (Portcls.h を含む)
Library	Portcls.lib
IRQL	PASSIVE_LEVEL