Função PcRegisterPhysicalConnection (portcls.h)

A função PcRegisterPhysicalConnection registra uma conexão física entre dois filtros de adaptador de áudio que são instanciados pelo mesmo driver do adaptador.

Sintaxe

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnection(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PUNKNOWN       FromUnknown,
  [in] ULONG          FromPin,
  [in] PUNKNOWN       ToUnknown,
  [in] ULONG          ToPin
);

Parâmetros

[in] DeviceObject

Ponteiro para o objeto do dispositivo para o dispositivo adaptador. Esse parâmetro deve apontar para uma estrutura do sistema do tipo DEVICE_OBJECT.

[in] FromUnknown

Ponteiro para a interface IPort de um objeto de driver de porta. O objeto de driver de porta associado ao FromUnknown está associado ao subdevice que fornece o pino de fonte de dados (saída) da conexão.

[in] FromPin

Especifica uma ID do pino. Esse parâmetro identifica o pino de origem (saída) no filtro associado à interface FromUnknown .

[in] ToUnknown

Ponteiro para a interface IPort de um objeto de driver de porta. O objeto de driver de porta associado ao ToUnknown está associado ao subdevice que fornece o pino de coletor de dados (entrada) da conexão.

[in] ToPin

Especifica uma ID do pino. Esse parâmetro identifica o pino de coletor (entrada) no filtro associado à interface ToUnknown .

Valor retornado

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

Comentários

Um driver de adaptador chama PcRegisterPhysicalConnection para registrar uma conexão física com o driver do sistema PortCls. O PortCls armazena essas informações para que o driver de porta possa usar posteriormente as informações para responder às solicitações de propriedade KSPROPERTY_PIN_PHYSICALCONNECTION .

Os parâmetros que o chamador fornece à função PcRegisterPhysicalConnection descrevem uma conexão física entre dois subdevices (representados como filtros individuais) no mesmo cartão do adaptador.

Ao contrário de uma conexão lógica entre dois pinos, que pode ser configurada sob controle de software, uma conexão física é ligada. Por exemplo, um cartão adaptador típico pode ter uma conexão física que carrega o sinal analógico do pino de saída de seu filtro de saída de onda para o pino de entrada de seu filtro de topologia.

Para obter um exemplo da rotina de inicialização de dispositivo de um driver de adaptador (consulte a Sequência de Inicialização) que usa a chamada PcRegisterPhysicalConnection para registrar as conexões físicas de um adaptador, consulte o código-fonte do driver de áudio de exemplo SB16 no WDK (Microsoft Windows Driver Kit).

Um driver de adaptador pode chamar o método IUnregisterPhysicalConnection::UnregisterPhysicalConnection para excluir o registro de uma conexão física que foi registrada por uma chamada anterior para PcRegisterPhysicalConnection. Para obter mais informações, consulte Subdevices de Áudio Dinâmico.

Requisitos

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

Confira também

DEVICE_OBJECT

Iport

IUnregisterPhysicalConnection::UnregisterPhysicalConnection

KSPROPERTY_PIN_PHYSICALCONNECTION

PcRegisterPhysicalConnectionFromExternal

PcRegisterPhysicalConnectionToExternal