Função PcRegisterPhysicalConnectionToExternal (portcls.h)

Artigo
08/07/2023

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

Sintaxe

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionToExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNKNOWN        FromUnknown,
  [in] ULONG           FromPin,
  [in] PUNICODE_STRING ToString,
  [in] ULONG           ToPin
);

Parâmetros

[in] DeviceObject

Ponteiro para o objeto do dispositivo para o dispositivo. Essa é 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 pin. Esse parâmetro identifica o pino de origem (saída) no filtro associado à interface FromUnknown .

[in] ToString

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

[in] ToPin

Especifica uma ID de pin. Esse parâmetro identifica o pino do coletor (entrada) no filtro externo nomeado por ToString.

Retornar valor

PcRegisterPhysicalConnectionToExternal 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 PcRegisterPhysicalConnectionToExternal 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 ToString é 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 dinamicamente por um programa de configuração do modo de usuário que coordena as alterações na configuração de ambos os dispositivos.

Um driver de adaptador pode chamar o método IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal para excluir o registro de uma conexão física que foi registrada por uma chamada anterior para PcRegisterPhysicalConnectionToExternal. 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 PcRegisterPhysicalConnectionToExternal no Microsoft Windows 98/Me e nos sistemas operacionais Windows 2000 e posteriores.
Plataforma de Destino	Universal
Cabeçalho	portcls.h (inclua Portcls.h)
Biblioteca	Portcls.lib
IRQL	PASSIVE_LEVEL