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 バージョンの概要 参照してください。

必要条件

要件	価値
ヘッダー	acxevents.h
IRQL	PASSIVE_LEVEL

関連項目

• acxevents.h ヘッダー を する