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

Статья
08/07/2023

Функция PcNewMiniport создает экземпляр одного из предоставляемых системой драйверов miniport, встроенных в системный драйвер PortCls, portcls.sys. Идентификатор класса указывает, какой из этих драйверов минипорта следует создать. Драйвер поддерживает интерфейс мини-порта, производный от IMiniport.

Синтаксис

PORTCLASSAPI NTSTATUS PcNewMiniport(
  [out] PMINIPORT *OutMiniPort,
  [in]  REFCLSID  ClassID
);

Параметры

[out] OutMiniPort

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

[in] ClassID

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

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

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

Системные драйверы минипорта для UART MPU-401 и синтезаторов OPL3 можно создать, вызвав pcNewMiniport . Это встроенные драйверы минипорта, которые предоставляются вместе с системным драйвером portcls.sys. Драйверы miniport, которые являются частью драйвера адаптера поставщика, не создаются таким образом.

Для параметра ClassId можно задать один из идентификаторов GUID, приведенных в следующей таблице.

GUID	Драйвер System-Supplied
CLSID_MiniportDriverDMusUART	Драйвер мини-порта DMusUART для синтезатора MPU-401. Предоставляет интерфейс IMiniportDMus для использования с объектом порта IPortDMus .
CLSID_MiniportDriverDMusUARTCapture	Драйвер мини-порта DMusUARTCapture для устройства захвата MPU-401. Предоставляет интерфейс IMiniportDMus для использования с объектом порта IPortDMus .
CLSID_MiniportDriverFmSynth	Драйвер мини-порта FmSynth для устройства синтезатора FM. Предоставляет интерфейс IMiniportMidi для использования с объектом порта IPortMidi .
CLSID_MiniportDriverFmSynthWithVol	Аналогично предыдущей записи, за исключением того, что драйвер также поддерживает узел тома.
CLSID_MiniportDriverUart	Драйвер минипорта UART для синтезатора MPU-401. Предоставляет интерфейс IMiniportMidi для использования с объектом порта IPortMidi . Является устаревшей.

Первые два идентификатора GUID в предыдущей таблице определены в файле заголовка dmusicks.h; последние три определяются в portcls.h.

Драйвер мини-порта DMusUART выводит данные MIDI на устройство синтезатора с чистым интерфейсом MIDI MPU-401. Для создания звука этому устройству требуется внешний звуковой модуль MIDI, подключенный к нему.

Драйвер мини-порта DMusUARTCapture вводит данные MIDI с устройства захвата с помощью чистого интерфейса MPU-401.

Драйвер минипорта FMSynth выводит данные MIDI на синтезатор, которое реализует синтез в стиле OPL3 FM. GUID CLSID_MiniportDriverFmSynth подходит для большинства устройств синтезатора FM. Однако устройства, такие как звуковая система Windows, которые не обеспечивают аппаратного контроля громкости после синтезатора FM, должны использовать вместо этого CLSID_MiniportDriverFmSynthWithVol GUID. В Windows Server с пакетом обновления 1 (SP1) и более поздних версиях драйвер мини-порта FMSynth доступен только в 32-разрядных версиях операционной системы.

Драйвер минипорта UART устарел. Новый код драйвера адаптера должен использовать драйвер мини-порта DMusUART, который заменяет UART и реализует надмножество его функций.

Корпорация Майкрософт предоставляет исходный код для драйверов мини-порта DMusUART и FMSynth, который может служить отправной точкой для поставщиков оборудования, которым может потребоваться расширить эти драйверы для управления дополнительными возможностями устройств. Просмотрите примеры аудиодрайверов в комплекте драйверов Windows (WDK).

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

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

Требования

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

См. также раздел