Функция PcNewPort (portcls.h)

Статья
08/07/2023

Функция PcNewPort создает новый системный объект port-driver, интерфейс которого (производный от базового класса IPort) задается идентификатором класса.

Синтаксис

PORTCLASSAPI NTSTATUS PcNewPort(
  [out] PPORT    *OutPort,
  [in]  REFCLSID ClassID
);

Параметры

[out] OutPort

Выходной указатель для объекта port-driver, созданного этой функцией. Этот параметр указывает на переменную указателя, выделенную вызывающим объектом, в которую функция выводит указатель на созданный объект IPort . Этот объект имеет интерфейс порта, заданный параметром ClassId . Укажите допустимое значение указателя, отличное от NULL, для этого параметра.

[in] ClassID

Указывает тип запрашиваемого интерфейса порта. Дополнительные сведения см. в разделе "Примечания".

Возвращаемое значение

PcNewPort возвращает STATUS_SUCCESS, если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки.

GUID класса	Имя интерфейса порта
CLSID_PortDMus	IPortDMus
CLSID_PortMidi	IPortMidi
CLSID_PortTopology	IPortTopology
CLSID_PortWaveCyclic	IPortWaveCyclic
CLSID_PortWavePci	IPortWavePci
CLSID_PortWaveRT	IPortWaveRT

В Microsoft Windows XP и более поздних версиях драйверы портов MIDI и DirectMusic используют одну и ту же внутреннюю реализацию программного обеспечения. Это означает, что GUID CLSID_PortMidi эквивалентен CLSID_PortDMus.

Дополнительные сведения о создании драйверов портов и мини-портов для дочерних служб см. в разделе Создание поддефикатов.

Параметр OutPort соответствует соглашениям о подсчете ссылок для COM-объектов.

Требования

Требование	Значение
Минимальная версия клиента	Системный драйвер PortCls реализует функцию PcNewPort в Microsoft Windows 98/Me, а также в операционных системах Windows 2000 и более поздних версий.
Целевая платформа	Универсальное
Верхняя часть	portcls.h (включая Portcls.h)
Библиотека	Portcls.lib
IRQL	PASSIVE_LEVEL