Funzione PcNewPort (portcls.h)

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.

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

Vedi anche

IPort

IPortDMus

IPortMidi

IPortTopology

IPortWaveCyclic

IPortWavePci

IPortWaveRT