Funzione PcNewPort (portcls.h)

Articolo
02/29/2024

La funzione PcNewPort crea un nuovo oggetto port-driver fornito dal sistema, la cui interfaccia (derivata dalla classe base IPort) viene specificata da un ID classe.

Sintassi

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

Parametri

[out] OutPort

Puntatore di output per l'oggetto port-driver creato da questa funzione. Questo parametro punta a una variabile puntatore allocata dal chiamante in cui la funzione restituisce il puntatore all'oggetto IPort appena creato. Questo oggetto ha l'interfaccia della porta specificata dal parametro ClassId . Specificare un valore di puntatore non NULL valido per questo parametro.

[in] ClassID

Specifica il tipo di interfaccia di porta richiesta. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

PcNewPort restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.

Commenti

Il parametro ClassId può essere impostato su uno dei GUID nella tabella seguente.

GUID di classe	Nome interfaccia porta
CLSID_PortDMus	IPortDMus
CLSID_PortMidi	IPortMidi
CLSID_PortTopology	IPortTopology
CLSID_PortWaveCyclic	IPortWaveCyclic
CLSID_PortWavePci	IPortWavePci
CLSID_PortWaveRT	IPortWaveRT

CLSID_PortDMus è definito nel file di intestazione dmusicks.h. Gli altri quattro GUID nella tabella precedente sono definiti in portcls.h.

In Microsoft Windows XP e versioni successive, i driver di porta MIDI e DirectMusic condividono la stessa implementazione software interna. Ciò significa che il GUID CLSID_PortMidi equivale a CLSID_PortDMus.

Per altre informazioni sulla creazione di driver di porta e miniport per i sottodispositivi, vedere Creazione di sottodispositivi.

Il parametro OutPort segue le convenzioni di conteggio dei riferimenti per gli oggetti COM.

Requisiti

Requisito	Valore
Client minimo supportato	Il driver di sistema PortCls implementa la funzione PcNewPort in Microsoft Windows 98/Me e nei sistemi operativi Windows 2000 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	portcls.h (include Portcls.h)
Libreria	Portcls.lib
IRQL	PASSIVE_LEVEL