Método IUnregisterPhysicalConnection::UnregisterPhysicalConnection (portcls.h)

Artigo
02/29/2024

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

Sintaxe

NTSTATUS UnregisterPhysicalConnection(
  [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 a FromUnknown está associado ao subdispositivo que fornece o pin da fonte de dados da conexão.

[in] FromPin

Especifica uma ID de pino. Esse parâmetro identifica o pino de fonte de dados (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 a ToUnknown está associado ao subdispositivo que fornece o pin do coletor de dados da conexão.

[in] ToPin

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

Retornar valor

UnregisterPhysicalConnection retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.