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
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal
Comentários
Enviar e exibir comentários de