次の方法で共有


PcRegisterPhysicalConnectionToExternal 関数 (portcls.h)

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

こちらもご覧ください

DEVICE_OBJECT

IPort

IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal

KSPROPERTY_PIN_PHYSICALCONNECTION

PcRegisterPhysicalConnection

PcRegisterPhysicalConnectionFromExternal