EVT_ACX_PIN_DISCONNECTED callback function (acxpin.h)

Artikel
02/22/2024

The EVT_ACX_PIN_DISCONNECTED callback function is implemented by the driver and is called when the circuit bridge pin is disconnected from the pin of another circuit.

Syntax

EVT_ACX_PIN_DISCONNECTED EvtAcxPinDisconnected;

void EvtAcxPinDisconnected(
  ACXPIN Pin,
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG TargetPinId
)
{...}

Parameters

Pin

An ACXPIN object representing the specific pin that was disconnected.

TargetCircuit

An ACXTARGETCIRCUIT object representing the circuit from which the Pin was disconnected.

TargetPinId

The identifier of the pin in the TargetCircuit from which the Pin was disconnected.

Return value

None

Remarks

This callback is not guaranteed to be called in the following scenarios:

This device is removed or surprised-removed.
This device is disabled (query-removed and removed) via device manager.

A driver must not rely on this callback as its only resource cleanup.

The specified ACXTARGETCIRCUIT may be already in its stop state b/c the target circuit may already be gone.

Driver can still access its ACXTARGETCIRCUIT context.

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement	Value
Header	acxpin.h
IRQL	PASSIVE_LEVEL

Delen via