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