Función PcNewPort (portcls.h)

Artículo
02/26/2024

La función PcNewPort crea un nuevo objeto port-driver proporcionado por el sistema, cuya interfaz (derivada de la clase base IPort) se especifica mediante un identificador de clase.

Sintaxis

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

Parámetros

[out] OutPort

Puntero de salida para el objeto port-driver creado por esta función. Este parámetro apunta a una variable de puntero asignada por el autor de la llamada en la que la función genera el puntero al objeto IPort recién creado. Este objeto tiene la interfaz de puerto especificada por el parámetro ClassId . Especifique un valor de puntero válido que no sea NULL para este parámetro.

[in] ClassID

Especifica el tipo de interfaz de puerto que se solicita. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

PcNewPort devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.

Comentarios

El parámetro ClassId se puede establecer en uno de los GUID de la tabla siguiente.

GUID de clase	Nombre de la interfaz de puerto
CLSID_PortDMus	IPortDMus
CLSID_PortMidi	IPortMidi
CLSID_PortTopology	IPortTopology
CLSID_PortWaveCyclic	IPortWaveCíclico
CLSID_PortWavePci	IPortWavePci
CLSID_PortWaveRT	IPortWaveRT

CLSID_PortDMus se define en el archivo de encabezado dmusicks.h. Los otros cuatro GUID de la tabla anterior se definen en portcls.h.

En Microsoft Windows XP y versiones posteriores, los controladores de puerto MIDI y DirectMusic comparten la misma implementación de software interna. Esto significa que el GUID de CLSID_PortMidi es equivalente a CLSID_PortDMus.

Para obtener más información sobre cómo crear controladores de puerto y minipuerto para subdispositivos, vea Creación de subdispositivos.

El parámetro OutPort sigue las convenciones de recuento de referencias para objetos COM.

Requisitos

Requisito	Value
Cliente mínimo compatible	El controlador del sistema PortCls implementa la función PcNewPort en Microsoft Windows 98/Me y en los sistemas operativos Windows 2000 y versiones posteriores.
Plataforma de destino	Universal
Encabezado	portcls.h (incluir Portcls.h)
Library	Portcls.lib
IRQL	PASSIVE_LEVEL