AcxMuteCreate 関数 (acxelements.h)
AcxMuteCreate 関数は、回線オブジェクトの親に関連付けられる ACX ミュート オブジェクトを作成するために使用されます。
構文
NTSTATUS AcxMuteCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_MUTE_CONFIG Config,
ACXMUTE *Mute
);
パラメーター
Object
回線に関連付けられる WDFDEVICE オブジェクト ( フレームワーク オブジェクトの概要に関するページで説明)。
Attributes
さまざまな値を設定し、ミュート オブジェクトを親回線オブジェクトに関連付けるために使用される 、WDF_OBJECT_ATTRIBUTES 構造を使用して定義された追加の属性。
Config
ミュート動作の構成を記述する初期化された ACX_MUTE_CONFIG構造体 。
Mute
新しく作成された ACXMUTE オブジェクトへのハンドルを受け取る場所へのポインター。 ACX オブジェクトの詳細については、「 ACX オブジェクトの概要」を参照してください。
戻り値
STATUS_SUCCESS呼び出しが成功した場合は を返します。 それ以外の場合は、適切なエラー コードを返します。 詳細については、「 NTSTATUS 値の使用」を参照してください。
解説
例
使用例を次に示します。
NTSTATUS status;
WDF_OBJECT_ATTRIBUTES attributes;
ACX_MUTE_CALLBACKS muteCallbacks;
ACX_MUTE_CONFIG muteCfg;
ACXMUTE muteElement;
ACX_MUTE_CALLBACKS_INIT(&muteCallbacks);
muteCallbacks.EvtAcxMuteAssignState = CodecR_EvtMuteAssignState;
muteCallbacks.EvtAcxMuteRetrieveState = CodecR_EvtMuteRetrieveState;
ACX_MUTE_CONFIG_INIT(&muteCfg);
muteCfg.ChannelsCount = MAX_CHANNELS;
muteCfg.Name = &KSAUDFNAME_WAVE_MUTE;
muteCfg.Callbacks = &muteCallbacks;
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_MUTE_ELEMENT_CONTEXT);
attributes.ParentObject = Circuit;
status = AcxMuteCreate(Circuit, &attributes, &muteCfg, &muteElement);
ACX の要件
最小 ACX バージョン: 1.0
ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。
要件
| 要件 | 値 |
|---|---|
| Header | acxelements.h |
| IRQL | PASSIVE_LEVEL |