次の方法で共有

EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN コールバック関数 (acxcircuit.h)

  • [アーティクル]

EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN コールバックは、ACXFACTORYCIRCUIT オブジェクトの電源ダウン パスに機能を追加するためにドライバーによって使用されます。

構文

EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN EvtAcxFactoryCircuitPowerDown;

NTSTATUS EvtAcxFactoryCircuitPowerDown(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDF_POWER_DEVICE_STATE TargetState
)
{...}

パラメーター

Device

ACX 回線に関連付けられている WDFDEVICE オブジェクト (フレームワーク オブジェクト の概要で説明)。

Factory

既存の回線ファクトリ ACXFACTORYCIRCUIT オブジェクト。 ACX オブジェクトの詳細については、ACX オブジェクトの概要を参照してください。

TargetState

ターゲット デバイスの電源状態を識別する WDF_POWER_DEVICE_STATE 列挙。

戻り値

呼び出しが成功した場合に STATUS_SUCCESS を返します。 それ以外の場合は、適切なエラー コードが返されます。 詳細については、NTSTATUS 値 の使用に関するを参照してください。

備考

EvtAcxFactoryCircuitPrepareHardware コールバック関数を登録するには、ドライバーが AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks を呼び出す必要があります。

ドライバーが EvtCircuitPowerDown コールバック関数を登録している場合、ACX フレームワークは、ドライバーのデバイスの 1 つが動作 (D0) 状態を離れるたびに関数を呼び出します。 デバイスは、次のいずれかが発生すると D0 状態になります。

  • システムとそのすべてのデバイスは、動作状態を残し、低電力状態に入りようとしています。
  • デバイスが低電力アイドルをサポートしている場合、デバイスはアイドル状態であるため、低電力状態に入りようとしています。
  • プラグ アンド プレイ マネージャーは、システムのハードウェア リソースを再配布しようとしています。
  • ユーザーは、通常、アプリケーションのユーザー インターフェイスを使用して、デバイスを削除することを示しています。
  • また、デバイスが予期せず削除された (突然削除された) 後に、フレームワークは EvtFactoryCircuitPowerDown コールバック関数も呼び出します。

フレームワークがこのコールバック関数を呼び出すタイミングの詳細については、「PnP と電源管理のシナリオ を参照してください。

デバイスが突然削除されていない限り、ACX フレームワークは、デバイスの割り込みを無効にした直後に、デバイスの電源が D0 から減少する前、および WDF が関連付けられているデバイスでドライバーの EvtDeviceD0Exit コールバックを呼び出す前に、このコールバック関数を呼び出します。 TargetState パラメーターは、デバイスが入力しようとしているデバイスの電源状態を識別します。

EvtFactoryCircuitPowerDown コールバック関数は、ACXFACTORYCIRCUT のハードウェアが指定された低電力状態になる前に必要な操作を実行する必要があります。たとえば、ACXFACTORYCIRCUIT のハードウェアを D0 電源状態に復元するためにドライバーが後で必要とする情報を保存するなどです。

TargetState が WdfPowerDeviceD3Final の場合は、システムがオフになっているか、関連付けられているデバイスが削除されようとしているか、リソースの再調整が進行中であると想定する必要があります。 ドライバーが情報を保存する必要がある場合は、ディスクまたはその他の永続的な記憶域メディアに書き込む必要があります。

このコールバック関数を提供するドライバーの詳細については、「Function Driverでの PnP と電源管理のサポート」を参照してください。

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、ACX バージョンの概要 参照してください。

必要条件

要件 価値
ヘッダー acxcircuit.h
IRQL PASSIVE_LEVEL

関連項目

  • acxcircuit.h ヘッダー を する