Compartilhar via

Interface IUnregisterPhysicalConnection (portcls.h)

  • Artigo

A IUnregisterPhysicalConnection interface implementa três métodos para remover uma conexão física registrada. O driver de porta implementa essa interface. Para determinar se um driver de porta dá suporte à IUnregisterPhysicalConnection interface, um driver de miniporto chama o método QueryInterface do objeto de driver de porta com IID_IUNREGISTERPHYSICALCONNECTION REFIID. O driver de miniporto é responsável por liberar o IUnregisterPhysicalConnection objeto depois que ele não for mais necessário. A IUnregisterPhysicalConnection interface herda de IUnknown.

Os seguintes drivers de porta dão suporte à IUnregisterSubdevice interface:

  • WaveCyclic
  • WavePci
  • Topologia
  • DMus
  • MIDI
Os três métodos nessa interface "cancelam o registro" de conexões físicas que foram registradas anteriormente por chamadas para as rotinas PcRegisterPhysicalConnection, PcRegisterPhysicalConnectionFromExternal ou PcRegisterPhysicalConnectionToExternal . PortCls dá suporte às três rotinas PcRegisterPhysicalConnectionXxx .

O driver de porta usa as informações obtidas de chamadas PcRegisterPhysicalConnectionXxx para responder a solicitações de propriedade KSPROPERTY_PIN_PHYSICALCONNECTION.

Ao excluir um subdévico da topologia de um adaptador, o driver deve cancelar o registro das conexões físicas do subdévico com essa parte da topologia. A falha ao cancelar o registro das conexões físicas do subdévico pode causar vazamentos de memória.

Herança

A interface IUnregisterPhysicalConnection herda da interface IUnknown . IUnregisterPhysicalConnection também tem estes tipos de membros:

Métodos

A interface IUnregisterPhysicalConnection tem esses métodos.

 
IUnregisterPhysicalConnection::UnregisterPhysicalConnection

O método UnregisterPhysicalConnection exclui o registro de uma conexão física que foi registrada por uma chamada anterior para PcRegisterPhysicalConnection.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal

O método UnregisterPhysicalConnectionFromExternal exclui o registro de uma conexão física que foi registrada por uma chamada anterior para PcRegisterPhysicalConnectionFromExternal.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal

O método UnregisterPhysicalConnectionToExternal exclui o registro de uma conexão física que foi registrada por uma chamada anterior para PcRegisterPhysicalConnectionToExternal.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho portcls.h