IUnregisterPhysicalConnection::UnregisterPhysicalConnection-Methode (portcls.h)

Artikel
03/05/2024

Die UnregisterPhysicalConnection -Methode löscht die Registrierung einer physischen Verbindung, die durch einen vorherigen Aufruf von PcRegisterPhysicalConnection registriert wurde.

Syntax

NTSTATUS UnregisterPhysicalConnection(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PUNKNOWN       FromUnknown,
  [in] ULONG          FromPin,
  [in] PUNKNOWN       ToUnknown,
  [in] ULONG          ToPin
);

Parameter

[in] DeviceObject

Zeiger auf das Geräteobjekt für das Adaptergerät. Dieser Parameter muss auf eine Systemstruktur vom Typ DEVICE_OBJECT verweisen.

[in] FromUnknown

Zeiger auf die IPort-Schnittstelle eines Porttreiberobjekts. Das Porttreiberobjekt, das FromUnknown zugeordnet ist, ist an das Untergerät gebunden, das den Datenquellenpin der Verbindung bereitstellt.

[in] FromPin

Gibt eine Pin-ID an. Dieser Parameter identifiziert den Datenquellen-Pin (Ausgabe) auf dem Filter, der der FromUnknown-Schnittstelle zugeordnet ist.

[in] ToUnknown

Zeiger auf die IPort-Schnittstelle eines Porttreiberobjekts. Das Porttreiberobjekt, das ToUnknown zugeordnet ist, ist an das Untergerät gebunden, das den Datensenkennadel der Verbindung bereitstellt.

[in] ToPin

Gibt eine Pin-ID an. Dieser Parameter identifiziert die Datensenke (Eingabe)-Pin auf dem Filter, der der ToUnknown-Schnittstelle zugeordnet ist.

Rückgabewert

UnregisterPhysicalConnection gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.