IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal-Methode (portcls.h)

Artikel
02/26/2024

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

Syntax

NTSTATUS UnregisterPhysicalConnectionToExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNKNOWN        FromUnknown,
  [in] ULONG           FromPin,
  [in] PUNICODE_STRING ToString,
  [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 Datenquellen-Pin der Verbindung bereitstellt.

[in] FromPin

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

[in] ToString

Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den Namen des externen Filters enthält, der die Datensenke der Verbindung bereitstellt.

[in] ToPin

Gibt eine Pin-ID an. Dieser Parameter identifiziert die Datensenke (Eingabe) für den externen Filter, der durch den ToString-Parameter benannt wird.

Rückgabewert

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