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 por 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, 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.
Valor de retorno
PcNewPort retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.
Observações
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 | |
| CLSID_PortMidi | |
| CLSID_PortTopology | |
| CLSID_PortWaveCyclic | |
| CLSID_PortWavePci | |
| CLSID_PortWaveRT |
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 de miniporto para subdevices, consulte de Criação de Subdevice.
O parâmetro OutPort segue as convenções de contagem de referência para objetos COM.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | O driver do sistema PortCls implementa a função PcNewPort no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores. |
| da Plataforma de Destino | Universal |
| cabeçalho | portcls.h (inclua Portcls.h) |
| biblioteca | Portcls.lib |
| IRQL | PASSIVE_LEVEL |