PcNewPort-Funktion (portcls.h)

Artikel
02/07/2025

Die PcNewPort--Funktion erstellt ein neues vom System bereitgestelltes Porttreiberobjekt, dessen Schnittstelle (abgeleitet von der Basisklasse IPort) durch eine Klassen-ID angegeben wird.

Syntax

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

Parameter

[out] OutPort

Ausgabezeiger für das von dieser Funktion erstellte Porttreiberobjekt. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene Zeigervariable, in die die Funktion den Zeiger auf das neu erstellte IPort-Objekt ausgibt. Dieses Objekt verfügt über die Portschnittstelle, die durch den parameter ClassId angegeben wird. Geben Sie einen gültigen, nicht NULL-Zeigerwert für diesen Parameter an.

[in] ClassID

Gibt den Typ der angeforderten Portschnittstelle an. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

PcNewPort- gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Bemerkungen

Der parameter ClassId kann auf eine der GUIDs in der folgenden Tabelle festgelegt werden.

Klassen-GUID	Portschnittstellenname
CLSID_PortDMus	IPortDMus-
CLSID_PortMidi	IPortMidi
CLSID_PortTopology	IPortTopology-
CLSID_PortWaveCyclic	IPortWaveCyclic
CLSID_PortWavePci	IPortWavePci-
CLSID_PortWaveRT	IPortWaveRT-

CLSID_PortDMus wird in der Headerdatei "dmusicks.h" definiert. Die anderen vier GUIDs in der vorherigen Tabelle werden in portcls.h definiert.

In Microsoft Windows XP und höher verwenden die MIDI- und DirectMusic-Porttreiber die gleiche interne Softwareimplementierung. Dies bedeutet, dass die CLSID_PortMidi GUID CLSID_PortDMusentspricht.

Weitere Informationen zum Erstellen von Port- und Miniporttreibern für Untergeräte finden Sie unter Subdevice Creation.

Der parameter OutPort folgt den Konventionen für referenzzählungskonventionen für COM-Objekte.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Der PortCls-Systemtreiber implementiert die PcNewPort-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höher.
Zielplattform-	Universal
Header-	portcls.h (include Portcls.h)
Library	Portcls.lib
IRQL-	PASSIVE_LEVEL