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 関数を実装します。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | portcls.h (Portcls.h を含む) |
| ライブラリ | Portcls.lib |
| IRQL | PASSIVE_LEVEL |
関連項目
IPort を する
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal