Função PcRegisterPhysicalConnection (portcls.h)

Artigo
02/26/2024

A função PcRegisterPhysicalConnection registra uma conexão física entre dois filtros de adaptador de áudio instanciados pelo mesmo driver de 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 a FromUnknown está associado ao subdispositivo que fornece o pino de fonte de dados (saída) da conexão.

[in] FromPin

Especifica uma ID de 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 a ToUnknown está associado ao subdispositivo que fornece o pino do coletor de dados (entrada) da conexão.

[in] ToPin

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

Retornar valor

PcRegisterPhysicalConnection retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará 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. PortCls armazena essas informações para que o driver de porta possa usar posteriormente as informações para responder a KSPROPERTY_PIN_PHYSICALCONNECTION solicitações de propriedade.

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

Ao contrário de uma conexão lógica entre dois pinos, que podem ser configurados sob controle de software, uma conexão física é ligada. Por exemplo, um adaptador típico cartão 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 do dispositivo de um driver de adaptador (consulte 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 Subdispositivos de Áudio Dinâmico.

Requisitos

Requisito	Valor
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