Compartilhar via


Função PcNewPort (portcls.h)

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

Confira também

Iport

IPortDMus

IPortMidi

IPortTopology

IPortWaveCyclic

IPortWavePci

IPortWaveRT