Función PcNewPort (portcls.h)
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 | |
CLSID_PortMidi | |
CLSID_PortTopology | |
CLSID_PortWaveCyclic | |
CLSID_PortWavePci | |
CLSID_PortWaveRT |
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 |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de