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 |