Edit

ACX_CIRCUIT_PNPPOWER_CALLBACKS structure (acxcircuit.h)

  • Article

The ACX_CIRCUIT_PNPPOWER_CALLBACKS structure contains pointers to an ACXCIRCUIT's Plug and Play and power event callback.

Syntax

typedef struct _ACX_CIRCUIT_PNPPOWER_CALLBACKS {
  ULONG                            Size;
  PFN_ACX_CIRCUIT_PREPARE_HARDWARE EvtAcxCircuitPrepareHardware;
  PFN_ACX_CIRCUIT_RELEASE_HARDWARE EvtAcxCircuitReleaseHardware;
  PFN_ACX_CIRCUIT_POWER_UP         EvtAcxCircuitPowerUp;
  PFN_ACX_CIRCUIT_POWER_DOWN       EvtAcxCircuitPowerDown;
} ACX_CIRCUIT_PNPPOWER_CALLBACKS, *PACX_CIRCUIT_PNPPOWER_CALLBACKS;

Members

Size

The size, in bytes, of this structure.

EvtAcxCircuitPrepareHardware

A pointer to the driver's ACX_CIRCUIT_PREPARE_HARDWARE callback event callback function, or NULL.

EvtAcxCircuitReleaseHardware

A pointer to the driver's ACX_CIRCUIT_RELEASE_HARDWARE callback event callback function, or NULL.

EvtAcxCircuitPowerUp

A pointer to the ACX_CIRCUIT_POWER_UP callback event callback function, or NULL.

EvtAcxCircuitPowerDown

A pointer to the ACX_CIRCUIT_POWER_DOWN callback event callback function, or NULL.

Remarks

The ACX_CIRCUIT_PNPPOWER_CALLBACKS structure is used as input to the AcxCircuitInitSetAcxCircuitPnpPowerCallbacks method.

Your driver should initialize its ACX_CIRCUIT_PNPPOWER_CALLBACKS structure by calling ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT.

Example

Example usage is shown below.

    //
    // Assign the circuit's pnp-power callbacks.
    //
    {
        ACX_CIRCUIT_PNPPOWER_CALLBACKS  powerCallbacks;
        ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT(&powerCallbacks);
        powerCallbacks.EvtAcxCircuitPowerUp = EvtCircuitPowerUp;
        powerCallbacks.EvtAcxCircuitPowerDown = EvtCircuitPowerDown;
        AcxCircuitInitSetAcxCircuitPnpPowerCallbacks(CircuitInit, &powerCallbacks);
    }
    
    status = AcxCircuitInitAssignAcxCreateStreamCallback(CircuitInit, EvtCircuitCreateStream);

ACX requirements

Minimum ACX version: 1.0

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

Requirements

Requirement Value
Header acxcircuit.h

See also

ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT

AcxCircuitInitSetAcxCircuitPnpPowerCallbacks method