Função PcRegisterPhysicalConnectionToExternal (portcls.h)
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 |
Confira também
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal