PcRegisterPhysicalConnection 関数 (portcls.h)

[アーティクル]
08/07/2023

PcRegisterPhysicalConnection 関数は、同じアダプタードライバーによってインスタンス化された 2 つのオーディオアダプターフィルター間の物理的な接続を登録します。

構文

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnection(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PUNKNOWN       FromUnknown,
  [in] ULONG          FromPin,
  [in] PUNKNOWN       ToUnknown,
  [in] ULONG          ToPin
);

パラメーター

[in] DeviceObject

アダプターデバイスのデバイスオブジェクトへのポインター。このパラメーターは、 DEVICE_OBJECT型のシステム構造を指す必要があります。

[in] FromUnknown

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

[in] FromPin

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

[in] ToUnknown

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

[in] ToPin

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

戻り値

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

注釈

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

呼び出し元が PcRegisterPhysicalConnection 関数に提供するパラメーターは、同じアダプターカード上の 2 つのサブデバイス間の物理的な接続 (個々のフィルターとして表されます) を記述します。

ソフトウェア制御下で構成できる 2 つのピン間の論理接続とは異なり、物理的な接続はハードワイヤードされます。たとえば、一般的なアダプターカードは、ウェーブ出力フィルターの出力ピンからトポロジフィルターの入力ピンにアナログ信号を伝送する物理接続を備えている場合があります。

PcRegisterPhysicalConnection 呼び出しを使用してアダプターの物理接続を登録するアダプタードライバーのデバイススタートアップルーチン (「スタートアップシーケンス」を参照) の例については、Microsoft Windows Driver Kit (WDK) の SB16 サンプルオーディオドライバーのソースコードを参照してください。

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

要件

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