Função PcNewPort (portcls.h)

Artigo
02/26/2024

A função PcNewPort cria um novo objeto de driver de porta fornecido pelo sistema, cuja interface (derivada da classe base IPort) é especificada por uma ID de classe.

Sintaxe

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

Parâmetros

[out] OutPort

Ponteiro de saída para o objeto port-driver criado por essa função. Esse parâmetro aponta para uma variável de ponteiro alocada pelo chamador na qual a função gera o ponteiro para o objeto IPort recém-criado. Esse objeto tem a interface de porta especificada pelo parâmetro ClassId . Especifique um valor de ponteiro válido e não NULL para esse parâmetro.

[in] ClassID

Especifica o tipo de interface de porta que está sendo solicitada. Para obter mais informações, consulte a seção Comentários a seguir.

Retornar valor

PcNewPort retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.

Comentários

O parâmetro ClassId pode ser definido como um dos GUIDs na tabela a seguir.

GUID de classe	Nome da interface da porta
CLSID_PortDMus	IPortDMus
CLSID_PortMidi	IPortMidi
CLSID_PortTopology	IPortTopology
CLSID_PortWaveCyclic	IPortWaveCyclic
CLSID_PortWavePci	IPortWavePci
CLSID_PortWaveRT	IPortWaveRT

CLSID_PortDMus é definido no arquivo de cabeçalho dmusicks.h. Os outros quatro GUIDs na tabela anterior são definidos em portcls.h.

No Microsoft Windows XP e posterior, os drivers de porta MIDI e DirectMusic compartilham a mesma implementação de software interno. Isso significa que o GUID do CLSID_PortMidi é equivalente a CLSID_PortDMus.

Para obter mais informações sobre como criar drivers de porta e miniport para subdispositivos, consulte Criação de subdispositivos.

O parâmetro OutPort segue as convenções de contagem de referência para objetos COM.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	O driver do sistema PortCls implementa a função PcNewPort no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores.
Plataforma de Destino	Universal
Cabeçalho	portcls.h (inclua Portcls.h)
Biblioteca	Portcls.lib
IRQL	PASSIVE_LEVEL