Metodo IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal (portcls.h)

Articolo
02/26/2024

Il UnregisterPhysicalConnectionToExternal metodo elimina la registrazione di una connessione fisica registrata da una chiamata precedente a PcRegisterPhysicalConnectionToExternal.

Sintassi

NTSTATUS UnregisterPhysicalConnectionToExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNKNOWN        FromUnknown,
  [in] ULONG           FromPin,
  [in] PUNICODE_STRING ToString,
  [in] ULONG           ToPin
);

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo per il dispositivo adattatore. Questo parametro deve puntare a una struttura di sistema di tipo DEVICE_OBJECT.

[in] FromUnknown

Puntatore all'interfaccia IPort di un oggetto driver di porta. L'oggetto driver di porta associato a FromUnknown è associato al sottodevice che fornisce il pin dell'origine dati della connessione.

[in] FromPin

Specifica un ID pin. Questo parametro identifica il pin dell'origine dati (output) nel filtro associato all'interfaccia FromUnknown .

[in] ToString

Puntatore a una stringa Unicode con terminazione null contenente il nome del filtro esterno che fornisce il pin del sink di dati della connessione.

[in] ToPin

Specifica un ID pin. Questo parametro identifica il pin del sink di dati (input) nel filtro esterno denominato dal parametro ToString .

Valore restituito

UnregisterPhysicalConnectionToExternal restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.