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

  • [アーティクル]

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE コールバックは、ドライバーが ACXCIRCUIT オブジェクトに関連付けられている以前に作成した WDFDEVICE を削除する必要がある場合に、ACX によって呼び出されます。

構文

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;

NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
  WDFDEVICE Parent,
  ACXFACTORYCIRCUIT Factory,
  WDFDEVICE Device
)
{...}

パラメーター

Parent

Device オブジェクトで参照される WDFDEVICE の親である WDFDEVICE オブジェクト (フレームワーク オブジェクトの概要に関するページで説明されています)。

Factory

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

Device

削除する必要がある WDFDEVICE オブジェクト ( フレームワーク オブジェクトの概要に関するページで説明)。

戻り値

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

注釈

AcxFactoryCircuit は、オンデマンドで ACXCIRCUIT を作成できるファクトリ オブジェクトを表します。

ドライバーは ACX に 1 つ以上の ACXFACTORYCIRCUIT を登録できます。このアクションにより、ドライバーが適切に定義された型の ACXCIRCUIT を作成できることが ACX に通知されます。

ACX は、オーディオ パスに ACXCIRCUIT が提供されているファクトリの 1 つが必要であることを検出すると、ACXFACTORYCIRCUIT のコールバックを呼び出します。

これは省略可能なコールバックです。EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE コールバックが定義されていない場合、ACX は、列挙されたデバイスの一覧から指定された WDFDEVICE を削除する既定のアクションを実行します。 このアクションにより、突然削除された PnP 通知が子 WDFDEVICE にトリガーされます。

ACXFACTORYCIRCUIT オブジェクトは動的 ACXCIRCUIT をサポートしています。つまり、ファクトリによって作成された各 ACXCIRCUIT は WDFDEVICE に関連付けられ、これら 2 つのオブジェクトの有効期間は同じです。

AcxFactoryCircuit には、専用の WDF キューがあります。 WDF キューの詳細については、「 フレームワーク キュー オブジェクト」を参照してください。

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件 値
Header acxcircuit.h
IRQL PASSIVE_LEVEL

こちらもご覧ください