Freigeben über


PcNewPort-Funktion (portcls.h)

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

Weitere Informationen

Iport

IPortDMus

IPortMidi

IPortTopology

IPortWaveCyclic

IPortWavePci

IPortWaveRT