PcNewPort-Funktion (portcls.h)

Artikel
02/26/2024

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

Syntax

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

Parameter

[out] OutPort

Ausgabezeiger für das port-driver-Objekt, das von dieser Funktion erstellt wurde. 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 vom ClassId-Parameter angegeben wird. Geben Sie einen gültigen Zeigerwert ohne NULL 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.

Hinweise

Der ClassId-Parameter 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 sind in portcls.h definiert.

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

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

Der OutPort-Parameter folgt den Referenzzählungskonventionen für COM-Objekte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Der PortCls-Systemtreiber implementiert die PcNewPort-Funktion in Microsoft Windows 98/Me und in Windows 2000 und höheren Betriebssystemen.
Zielplattform	Universell
Header	portcls.h (include Portcls.h)
Bibliothek	Portcls.lib
IRQL	PASSIVE_LEVEL