次の方法で共有

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

  • [アーティクル]

EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE コールバックは、ACXFACTORYCIRCUIT がリリース ハードウェア フェーズにあるときに機能を追加するためにドライバーによって使用されます。

構文

EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE EvtAcxFactoryCircuitReleaseHardware;

NTSTATUS EvtAcxFactoryCircuitReleaseHardware(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDFCMRESLIST ResourcesTranslated
)
{...}

パラメーター

Device

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

Factory

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

ResourcesTranslated

ハードウェア準備フェーズに使用する変換済みリソースを記述する WDF リソースリスト。 これは、デバイスのハードウェア リソースの一覧を表す WDF フレームワークリソースリストオブジェクトです。 翻訳されたリソース リストの詳細については、「未加工リソースと翻訳済みリソース」を参照してください。

戻り値

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

備考

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

ドライバーが EvtAcxFactoryCircuitReleaseHardware コールバック関数を登録している場合、フレームワークは次の遷移中にそれを呼び出します。

  • リソースの再調整
  • Orderly の削除
  • 突然の削除

ACX フレームワークは、WDF フレームワークがデバイスへの I/O 要求の送信を停止し、デバイスに割り当てられている割り込みが無効にされ、切断され、デバイスがオフになった後、EvtAcxFactoryCircuitReleaseHardware コールバック関数を呼び出します。

ACX フレームワークは、WDF フレームワークがドライバーの EvtDeviceReleaseHardware コールバック関数を呼び出す前に、EvtAcxFactoryCircuitReleaseHardware コールバック関数を呼び出します。

フレームワークが EvtAcxFactoryCircuitReleaseHardware を呼び出すと、デバイスの PDO は引き続き存在し、電源オフ状態 (PCI 構成状態など) で使用可能なデバイス情報を照会できます。

さらに、フレームワークが EvtDeviceReleaseHardware に提供する変換されたハードウェア リソースは、引き続きデバイスに割り当てられます。 このコールバック関数の主な目的は、これらのリソースを解放し、特にドライバーの EvtAcxCircuitPrepareHardware コールバック関数がマップしたメモリ リソースのマップを解除することです。 ドライバーは、このコールバックを使用して、電源ダウン状態で必要になる可能性があるその他の ACXCIRCUIT 管理アクティビティを実行することもできます。 通常、他のすべてのハードウェア シャットダウン操作は、ドライバーの EvtDeviceD0Exit コールバック関数で実行する必要があります。

EvtAcxFactoryCircuitPrepareHardware がエラー コードを返さない限り、ドライバーの EvtAcxFactoryCircuitPrepareHardware コールバック関数が呼び出された場合、ACX フレームワークは常にドライバーの EvtAcxFactoryCircuitReleaseHardware コールバック関数を呼び出します。

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

ハードウェア リソースの詳細については、「ハードウェア リソースの概要」を参照してください。

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

ACX の要件

最小 ACX バージョン: 1.0

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

必要条件

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

関連項目

  • acxcircuit.h ヘッダー を する