PcNewMiniport 関数 (portcls.h)

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

PcNewMiniport 関数は、PortCls システムドライバーに組み込まれているシステム提供のミニポートドライバーの 1 つのインスタンスを作成 portcls.sys。クラス ID は、インスタンス化するこれらのミニポートドライバーのどれを指定します。ドライバーは、 IMiniport から派生したミニポートインターフェイスをサポートしています。

構文

PORTCLASSAPI NTSTATUS PcNewMiniport(
  [out] PMINIPORT *OutMiniPort,
  [in]  REFCLSID  ClassID
);

パラメーター

[out] OutMiniPort

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

[in] ClassID

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

戻り値

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

注釈

MPU-401 UART および OPL3 シンセサイザー用のシステム提供のミニポートドライバーは、 PcNewMiniport を呼び出すことによってインスタンス化できます。これらは、portcls.sys システムドライバーと共に提供される組み込みのミニポートドライバーです。ベンダーのアダプタードライバーの一部であるミニポートドライバーは、この方法では作成されません。

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

GUID	System-Supplied ドライバー
CLSID_MiniportDriverDMusUART	MPU-401 シンセデバイスの DMusUART ミニポートドライバー。 IPortDMus ポートオブジェクトで使用する IMiniportDMus インターフェイスを公開します。
CLSID_MiniportDriverDMusUARTCapture	MPU-401 キャプチャデバイス用の DMusUARTCapture ミニポートドライバー。 IPortDMus ポートオブジェクトで使用する IMiniportDMus インターフェイスを公開します。
CLSID_MiniportDriverFmSynth	FM シンセデバイスの FmSynth ミニポートドライバー。 IPortMidi ポートオブジェクトで使用する IMiniportMidi インターフェイスを公開します。
CLSID_MiniportDriverFmSynthWithVol	前のエントリと同じですが、ドライバーでボリュームノードもサポートされている点が除きます。
CLSID_MiniportDriverUart	MPU-401 シンセデバイスの UART ミニポートドライバー。 IPortMidi ポートオブジェクトで使用する IMiniportMidi インターフェイスを公開します。互換性のために残されています。

前の表の最初の 2 つの GUID は、ヘッダーファイル dmusicks.h で定義されています。最後の 3 つが portcls.h で定義されています。

DMusUART ミニポートドライバーは、純粋な MPU-401 MIDI インターフェイスを持つシンセデバイスに MIDI データを出力します。サウンドを生成するには、このデバイスには外部 MIDI サウンドモジュールが接続されている必要があります。

DMusUARTCapture ミニポートドライバーは、純粋な MPU-401 インターフェイスを使用してキャプチャデバイスから MIDI データを入力します。

FMSynth ミニポートドライバーは、OPL3 スタイルの FM 合成を実装するシンセデバイスに MIDI データを出力します。 CLSID_MiniportDriverFmSynth GUID は、ほとんどの FM シンセデバイスに適しています。ただし、FM シンセの後にハードウェアボリュームコントロールを提供しない Windows サウンドシステムなどのデバイスでは、代わりに CLSID_MiniportDriverFmSynthWithVol GUID を使用する必要があります。 Windows Server SP1 以降では、FMSynth ミニポートドライバーは、オペレーティングシステムの 32 ビットバージョンでのみ使用できます。

UART ミニポートドライバーは廃止されました。新しいアダプタードライバーコードでは、UART を置き換え、その機能のスーパーセットを実装する DMusUART ミニポートドライバーを使用する必要があります。

Microsoft では、DMusUART および FMSynth ミニポートドライバーのソースコードを提供しています。これは、追加のデバイス機能を管理するためにこれらのドライバーを拡張する必要があるハードウェアベンダーの開始点として機能します。 Windows Driver Kit (WDK) のサンプルオーディオドライバーを確認します。

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

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

要件

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