PcRegisterSubdevice 関数 (portcls.h)

  • [アーティクル]

PcRegisterSubdevice 関数は、サブデバイスを登録して、クライアントで使用できるようにします。

構文

PORTCLASSAPI NTSTATUS PcRegisterSubdevice(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PWSTR          Name,
  [in] PUNKNOWN       Unknown
);

パラメーター

[in] DeviceObject

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

[in] Name

サブデバイスの名前を指定する null で終わる Unicode 文字列へのポインター。 Name パラメーターが指す文字列バッファーは、デバイス オブジェクトの有効期間にわたって有効なままである必要があります。 この文字列には、サブデバイスを同じデバイスに登録されている他のサブデバイスと区別する短い名前が含まれています。 各デバイスのサブデバイスには、一意の名前が必要です。

[in] Unknown

サブデバイスにバインドされているポート ドライバー オブジェクトの IPort インターフェイスへのポインター。

戻り値

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

注釈

関数は、オーディオ アダプターのサブデバイスを表すフィルター オブジェクトのデバイス インターフェイス インスタンスを登録します。 I/O マネージャーは 、Name パラメーターで指定された文字列を、インスタンスを識別するために使用する参照文字列に追加します。 変更された参照文字列は、オーディオ アダプター内のサブデバイスを区別するのに役立ちます。 参照文字列の詳細については、「 IoRegisterDeviceInterface」を参照してください。

サブデバイスの登録における PcRegisterSubdevice 関数の役割の詳細については、「 サブデバイスの作成」を参照してください。

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

要件

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

こちらもご覧ください

DEVICE_OBJECT

IPort

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface