AcxPnpEventCreate 関数 (acxevents.h)
AcxPnpEventCreate 関数は、ACXPNPEVENT を作成します。
構文
NTSTATUS AcxPnpEventCreate(
WDFDEVICE Device,
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_PNPEVENT_CONFIG Config,
ACXPNPEVENT *Event
);
パラメーター
Device
新しいイベントに関連付けられている既存の WDFDEVICE オブジェクト (フレームワーク オブジェクトの概要に関するページで説明)。
Object
イベントに関連付けられる ACX オブジェクトの概要に関するページで説明されている既存 の ACXAUDIOMODULE オブジェクト 。
Attributes
さまざまなオブジェクトの値を設定するために使用される WDF_OBJECT_ATTRIBUTES を使用して定義された追加の属性:コールバック、コンテキスト型のクリーンアップと破棄、および親オブジェクトの指定。
Config
ACX PNP イベントの構成を定義する ACX_PNPEVENT_CONFIG 構造体。
Event
ACXEVENT オブジェクト ( ACX オブジェクトの概要に関するページで説明されています)。
戻り値
STATUS_SUCCESS呼び出しが成功した場合は を返します。 それ以外の場合は、適切なエラー コードを返します。 詳細については、「 NTSTATUS 値の使用」を参照してください。
注釈
ACXPNPEVENT は、ドライバー レベルで使用できる非同期通知を表します。 PNP イベントは、任意のオブジェクトに追加できます。 現在、これらは ACXAUDIOMODULE オブジェクトと ACXKEYWARDSPOTTER オブジェクトで使用されています。 内部的に AcxPnpEvents は、上位レイヤーに PNP 非同期通知として公開されます。
例
このコード例では、AcxPnpEventCreate の使用方法を示します。
NTSTATUS status;
ACXAUDIOMODULE audioModuleElement;
WDF_OBJECT_ATTRIBUTES attributes;
ACX_PNPEVENT_CONFIG audioModuleEventCfg;
ACXPNPEVENT audioModuleEvent;
...
status = AcxAudioModuleCreate(Circuit, &attributes, &audioModuleCfg, &audioModuleElement);
audioModule0Ctx = GetCodecAudioModule0Context(audioModuleElement);
ACX_PNPEVENT_CONFIG_INIT(&audioModuleEventCfg);
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_PNPEVENT_CONTEXT);
attributes.ParentObject = audioModuleElement;
status = AcxPnpEventCreate(Device, audioModuleElement, &attributes, &audioModuleEventCfg, &audioModuleEvent);
ACX の要件
最小 ACX バージョン: 1.0
ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。
要件
| 要件 | 値 |
|---|---|
| Header | acxevents.h |
| IRQL | PASSIVE_LEVEL |