共用方式為


PcNewPort 函式 (portcls.h)

PcNewPort 函式會建立新的系統提供的埠驅動程序物件,其介面 (衍生自基類 IPort) 是由類別標識碼所指定。

語法

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 中。 上表中的其他四個 GUID 定義於 portcls.h 中。

在 Microsoft Windows XP 和更新版本中,MIDI 和 DirectMusic 埠驅動程式會共用相同的內部軟體實作。 這表示 CLSID_PortMidi GUID 相當於 CLSID_PortDMus

如需為子裝置建立埠和迷你埠驅動程序的詳細資訊,請參閱 子裝置建立

OutPort 參數會遵循 COM 對象的參考計數慣例

規格需求

需求
最低支援的用戶端 PortCls 系統驅動程式會在 Microsoft Windows 98/Me 和 Windows 2000 和更新版本的操作系統中實作 PcNewPort 函式。
目標平台 Universal
標頭 portcls.h (包括 Portcls.h)
程式庫 Portcls.lib
IRQL PASSIVE_LEVEL

另請參閱

IPort

IPortDMus

IPortMidi

IPortTopology

IPortWaveCyclic

IPortWavePci

IPortWaveRT