IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal method (portcls.h)

The UnregisterPhysicalConnectionToExternal method deletes the registration of a physical connection that was registered by a previous call to PcRegisterPhysicalConnectionToExternal.

Syntax

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

Parameters

[in] DeviceObject

Pointer to the device object for the adapter device. This parameter must point to a system structure of type DEVICE_OBJECT.

[in] FromUnknown

Pointer to the IPort interface of a port driver object. The port driver object that is associated with FromUnknown is bound to the subdevice that supplies the connection's data source pin.

[in] FromPin

Specifies a pin ID. This parameter identifies the data source (output) pin on the filter that is associated with the FromUnknown interface.

[in] ToString

Pointer to a null-terminated Unicode string that contains the name of the external filter that supplies the connection's data sink pin.

[in] ToPin

Specifies a pin ID. This parameter identifies the data sink (input) pin on the external filter that is named by the ToString parameter.

Return value

UnregisterPhysicalConnectionToExternal returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code.

Remarks

For more information, see Dynamic Audio Subdevices.

Requirements

Requirement Value
Target Platform Universal
Header portcls.h (include Portcls.h)
IRQL PASSIVE_LEVEL

See also

DEVICE_OBJECT

IPort

IUnregisterPhysicalConnection

PcRegisterPhysicalConnectionToExternal