PcRegisterPhysicalConnectionFromExternal 関数 (portcls.h)

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

構文

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionFromExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNICODE_STRING FromString,
  [in] ULONG           FromPin,
  [in] PUNKNOWN        ToUnknown,
  [in] ULONG           ToPin
);

パラメーター

[in] DeviceObject

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

[in] FromString

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

[in] FromPin

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

[in] ToUnknown

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

[in] ToPin

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

戻り値

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

注釈

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

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

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

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

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

要件

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

こちらもご覧ください

DEVICE_OBJECT

IPort

IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal

KSPROPERTY_PIN_PHYSICALCONNECTION

PcRegisterPhysicalConnection

PcRegisterPhysicalConnectionToExternal