Função PcRegisterPhysicalConnectionFromExternal (portcls.h)

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 para o 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 chamado 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 subdevice que fornece o pino de data sink (entrada) da conexão.

[in] ToPin

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

Valor retornado

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 subsequentemente usar as informações para responder a KSPROPERTY_PIN_PHYSICALCONNECTION 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 subdevice no adaptador de áudio local e um objeto de filtro que representa um subdevice em um adaptador externo.

O parâmetro FromString é um link simbólico para o subdevice 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 Dynamic Audio Subdevices.

Requisitos

   
Cliente mínimo com suporte O driver do sistema PortCls implementa a função PcRegisterPhysicalConnectionFromExternal no Microsoft Windows 98/Me e no Windows 2000 e sistemas operacionais 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::UnregisterPhysicalConnectionFromExternal

KSPROPERTY_PIN_PHYSICALCONNECTION

PcRegisterPhysicalConnection

PcRegisterPhysicalConnectionToExternal