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。

CLSID_PortDMus 定義於頭檔 dmusicks.h 中。上表中的其他四個 GUID 定義於 portcls.h 中。

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

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

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