次の方法で共有


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

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

構文

EVT_ACX_FACTORY_CIRCUIT_POWER_UP EvtAcxFactoryCircuitPowerUp;

NTSTATUS EvtAcxFactoryCircuitPowerUp(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDF_POWER_DEVICE_STATE PreviousState
)
{...}

パラメーター

Device

ACX 回線に関連付けられている WDFDEVICE オブジェクト ( フレームワーク オブジェクトの概要に関するページを参照)。

Factory

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

PreviousState

以前のデバイスの電源状態を識別するWDF_POWER_DEVICE_STATE列挙。

戻り値

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

ドライバーがこのコールバックに失敗した場合は、ACXFACTORYCIRCUIT を pending-delete としてタグ付けします。 ACX フレームワークは下線 ACX EvtDeviceD0Entry コールバックに失敗しません。これにより、このデバイスの既存の作業 ACXFACTORYCIRCUIT を使用して、動作するオーディオ パスを構築できます。

注釈

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

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

  • デバイスが列挙されます (デバイスが接続されたか、システムが再起動されたため)。
  • システムとそのすべてのデバイスは、低電力状態から動作状態に戻ります。
  • デバイスがアイドル状態であったため(デバイスが低電力アイドルをサポートしている場合)、低電力状態になった後に動作状態に戻ります。
  • プラグ アンド プレイ マネージャーは、システムのデバイス間でシステムのハードウェア リソースを再配布しました。
  • フレームワークは、デバイスが動作 (D0) 状態に入った直後に EvtDeviceD0Entry コールバック関数を呼び出し、ドライバーで使用できますが、デバイスの割り込みが有効になっている前に呼び出します。 PreviousState パラメーターは、デバイスが D0 状態になるまでのデバイスの電源状態を識別します。 フレームワークが最初に EvtDeviceD0Entry を呼び出すと、PreviousState 値 WdfPowerDeviceD3Final が提供されます。

このコールバック関数は、デバイスを完全に動作させるために必要な操作を実行する必要があります。

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

EvtFactoryCircuitPowerUp コールバック関数は、IRQL = PASSIVE_LEVELで呼び出されます。 このコールバック関数をページング可能にしないでください。

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件
Header acxcircuit.h
IRQL PASSIVE_LEVEL

こちらもご覧ください