Função PcRegisterPhysicalConnectionFromExternal (portcls.h)

Artigo
02/26/2024

A função PcRegisterPhysicalConnectionFromExternal registra uma conexão física com um filtro de adaptador de áudio de um filtro de adaptador de áudio externo.

Sintaxe

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionFromExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNICODE_STRING FromString,
  [in] ULONG           FromPin,
  [in] PUNKNOWN        ToUnknown,
  [in] ULONG           ToPin
);

Parâmetros

[in] DeviceObject

Ponteiro para o objeto de dispositivo do dispositivo. Essa é uma estrutura do sistema do tipo DEVICE_OBJECT.

[in] FromString

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do link simbólico do filtro externo que fornece o pino de origem da conexão.

[in] FromPin

Especifica uma ID de pino. Esse parâmetro identifica o pino de origem (saída) no filtro externo nomeado por FromString.

[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

PcRegisterPhysicalConnectionFromExternal 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 PcRegisterPhysicalConnectionFromExternal 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.

Essa função é útil para especificar um link de topologia entre dois adaptadores de áudio controlados por drivers de adaptador diferentes. A função registra uma conexão física entre um objeto de filtro que representa um subdispositivo no adaptador de áudio local e um objeto de filtro que representa um subdispositivo em um adaptador externo.

O parâmetro FromString é um link simbólico para o subdispositivo exposto pelo driver do adaptador externo.

As informações necessárias para registrar uma conexão física externa devem ser fornecidas aos dois drivers. Isso pode ser feito durante uma instalação coordenada inicial dos dois dispositivos ou pode ser feito dinamicamente por um programa de configuração de modo de usuário que coordena as alterações nas configurações de ambos os dispositivos.

Um driver de adaptador pode chamar o método IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal para excluir o registro de uma conexão física que foi registrada por uma chamada anterior para PcRegisterPhysicalConnectionFromExternal. 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 PcRegisterPhysicalConnectionFromExternal 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