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

Artigo
02/27/2024

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

Sintaxe

NTSTATUS UnregisterPhysicalConnectionFromExternal(
  [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 do dispositivo para o dispositivo adaptador. Esse parâmetro deve apontar para 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 filtro externo 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 externo nomeado pelo parâmetro 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 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

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