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 と Power Management のシナリオ」を参照してください。
ハードウェア リソースの詳細については、「ハードウェア リソース の概要」を参照してください。
このコールバック関数を提供するドライバーの詳細については、「 Function Driver での PnP と Power Management のサポート」を参照してください。
ACX の要件
最小 ACX バージョン: 1.0
ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。
要件
| 要件 | 値 |
|---|---|
| Header | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |