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 | |
| CLSID_PortMidi | |
| CLSID_PortTopology | |
| CLSID_PortWaveCyclic | |
| CLSID_PortWavePci | |
| CLSID_PortWaveRT |
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 |