PcNewMiniport 関数 (portcls.h)

[アーティクル]
02/07/2025

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 ミニポートドライバー。 IMiniportDMus インターフェイス IPortDMus ポートオブジェクトで使用できるように公開します。
CLSID_MiniportDriverDMusUARTCapture	MPU-401 キャプチャデバイスの DMusUARTCapture ミニポートドライバー。 IMiniportDMus インターフェイス IPortDMus ポートオブジェクトで使用できるように公開します。
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 関数を実装します。
ターゲットプラットフォームの	万国
ヘッダー	portcls.h (Portcls.h を含む)
ライブラリ	Portcls.lib
IRQL	PASSIVE_LEVEL

次の方法で共有

PcNewMiniport 関数 (portcls.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース