PcNewPort 函数 (portcls.h)
PcNewPort 函数创建一个新的系统提供的端口驱动程序对象，其接口 (派生自基类 IPort) 由类 ID 指定。
语法
PORTCLASSAPI NTSTATUS PcNewPort(
[out] PPORT *OutPort,
[in] REFCLSID ClassID
);
参数
[out] OutPort
此函数创建的端口驱动程序对象的输出指针。 此参数指向调用方分配的指针变量，函数将指针输出到新创建的 IPort 对象。 此对象具有由 ClassId 参数指定的端口接口。 为此参数指定有效的非 NULL 指针值。
[in] ClassID
指定要请求的端口接口的类型。 有关更多信息，请参见下面的“备注”部分。
返回值
如果调用成功，PcNewPort 将返回STATUS_SUCCESS。 否则，它将返回相应的错误代码。
注解
ClassId 参数可以设置为下表中的 GUID 之一。
| Class 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 函数。 |
| 目标平台 | 通用 |
| 标头 | portcls.h (包括 Portcls.h) |
| Library | Portcls.lib |
| IRQL | PASSIVE_LEVEL |