Função PcRegisterPhysicalConnection (portcls.h)
A função PcRegisterPhysicalConnection registra uma conexão física entre dois filtros de adaptador de áudio que são instanciados pelo mesmo driver do adaptador.
Sintaxe
PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnection(
[in] PDEVICE_OBJECT DeviceObject,
[in] PUNKNOWN FromUnknown,
[in] ULONG FromPin,
[in] PUNKNOWN ToUnknown,
[in] ULONG ToPin
);
Parâmetros
[in] DeviceObject
Ponteiro para o objeto do dispositivo para o dispositivo adaptador. Esse parâmetro deve apontar para 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 ao FromUnknown está associado ao subdevice que fornece o pino de fonte de dados (saída) da conexão.
[in] FromPin
Especifica uma ID do pino. Esse parâmetro identifica o pino de origem (saída) no filtro associado à interface FromUnknown .
[in] ToUnknown
Ponteiro para a interface IPort de um objeto de driver de porta. O objeto de driver de porta associado ao ToUnknown está associado ao subdevice que fornece o pino de coletor de dados (entrada) da conexão.
[in] ToPin
Especifica uma ID do pino. Esse parâmetro identifica o pino de coletor (entrada) no filtro associado à interface ToUnknown .
Valor retornado
PcRegisterPhysicalConnection retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retorna um código de erro apropriado.
Comentários
Um driver de adaptador chama PcRegisterPhysicalConnection para registrar uma conexão física com o driver do sistema PortCls. O PortCls armazena essas informações para que o driver de porta possa usar posteriormente as informações para responder às solicitações de propriedade KSPROPERTY_PIN_PHYSICALCONNECTION .
Os parâmetros que o chamador fornece à função PcRegisterPhysicalConnection descrevem uma conexão física entre dois subdevices (representados como filtros individuais) no mesmo cartão do adaptador.
Ao contrário de uma conexão lógica entre dois pinos, que pode ser configurada sob controle de software, uma conexão física é ligada. Por exemplo, um cartão adaptador típico pode ter uma conexão física que carrega o sinal analógico do pino de saída de seu filtro de saída de onda para o pino de entrada de seu filtro de topologia.
Para obter um exemplo da rotina de inicialização de dispositivo de um driver de adaptador (consulte a Sequência de Inicialização) que usa a chamada PcRegisterPhysicalConnection para registrar as conexões físicas de um adaptador, consulte o código-fonte do driver de áudio de exemplo SB16 no WDK (Microsoft Windows Driver Kit).
Um driver de adaptador pode chamar o método IUnregisterPhysicalConnection::UnregisterPhysicalConnection para excluir o registro de uma conexão física que foi registrada por uma chamada anterior para PcRegisterPhysicalConnection. Para obter mais informações, consulte Subdevices de Áudio Dinâmico.
Requisitos
| Cliente mínimo com suporte | O driver do sistema PortCls implementa a função PcRegisterPhysicalConnection 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 |
Confira também
IUnregisterPhysicalConnection::UnregisterPhysicalConnection
KSPROPERTY_PIN_PHYSICALCONNECTION