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

Artigo
02/26/2024

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

Sintaxe

NTSTATUS UnregisterPhysicalConnectionToExternal(
  [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 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 pin. Esse parâmetro identifica o pino de fonte de dados (saída) no filtro associado à interface FromUnknown .

[in] ToString

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do filtro externo que fornece o pin do coletor de dados da conexão.

[in] ToPin

Especifica uma ID de pin. Esse parâmetro identifica o pino do coletor de dados (entrada) no filtro externo nomeado pelo parâmetro ToString .

Retornar valor

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