PcNewPort 関数 (portcls.h)

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と同じです。

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

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

必要条件

要件	価値
サポートされる最小クライアント	PortCls システム ドライバーは、Microsoft Windows 98/Me および Windows 2000 以降のオペレーティング システムで PcNewPort 関数を実装します。
ターゲット プラットフォーム の	万国
ヘッダー	portcls.h (Portcls.h を含む)
ライブラリ	Portcls.lib
IRQL	PASSIVE_LEVEL

関連項目

IPort を する

IPortDMus を する

IPortMidi を する

IPortTopology

IPortWaveCyclic

IPortWavePci の

IPortWaveRT を する