PcNewPort 関数 (portcls.h)

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

PcNewPort 関数は、新しいシステム提供のポートドライバーオブジェクトを作成します。このオブジェクトのインターフェイス (基本クラス IPort から派生) はクラス ID で指定されます。

構文

PORTCLASSAPI NTSTATUS PcNewPort(
  [out] PPORT    *OutPort,
  [in]  REFCLSID ClassID
);

パラメーター

[out] OutPort

この関数によって作成されたポートドライバーオブジェクトの出力ポインター。このパラメーターは、呼び出し元によって割り当てられたポインター変数を指し、関数が新しく作成した IPort オブジェクトへのポインターを出力します。このオブジェクトには、 ClassId パラメーターで指定されたポートインターフェイスがあります。このパラメーターに有効な NULL 以外のポインター値を指定します。

[in] ClassID

要求されるポートインターフェイスの種類を指定します。詳細については、「解説」を参照してください。

戻り値

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

注釈

ClassId パラメーターは、次の表のいずれかの GUID に設定できます。

クラス GUID	ポートインターフェイス名
CLSID_PortDMus	IPortDMus
CLSID_PortMidi	IPortMidi
CLSID_PortTopology	IPortTopology
CLSID_PortWaveCyclic	IPortWaveCyclic
CLSID_PortWavePci	IPortWavePci
CLSID_PortWaveRT	IPortWaveRT

CLSID_PortDMus は、ヘッダーファイル dmusicks.h で定義されています。前の表の他の 4 つの GUID は portcls.h で定義されています。

Microsoft Windows XP 以降では、MIDI および DirectMusic ポートドライバーは、同じ内部ソフトウェア実装を共有します。つまり、 CLSID_PortMidi GUID は CLSID_PortDMusと同じです。

サブデバイスのポートドライバーとミニポートドライバーの作成の詳細については、「サブデバイスの作成」を参照してください。

OutPort パラメーターは、COM オブジェクトの参照カウント規則に従います。

要件

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