AcxMuteCreate-Funktion (acxelements.h)
Die AcxMuteCreate-Funktion wird verwendet, um ein ACX-Stummschaltobjekt zu erstellen, das einem übergeordneten Schaltkreisobjekt zugeordnet wird.
Syntax
NTSTATUS AcxMuteCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_MUTE_CONFIG Config,
ACXMUTE *Mute
);
Parameter
Object
Ein WDFDEVICE-Objekt (beschrieben in Zusammenfassung von Framework-Objekten), das dem Schaltkreis zugeordnet wird.
Attributes
Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES-Struktur definiert wurden, die zum Festlegen verschiedener Werte verwendet werden, und um das Stummschaltobjekt dem übergeordneten Schaltkreisobjekt zuzuordnen.
Config
Eine initialisierte ACX_MUTE_CONFIG Struktur, die die Konfiguration des Stummschaltverhaltens beschreibt.
Mute
Ein Zeiger auf eine Position, die das Handle an das neu erstellte ACXMUTE-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter Summary of ACX Objects.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Die Beispielverwendung wird unten gezeigt.
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-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxelements.h |
| IRQL- | PASSIVE_LEVEL |