Funzione AcxVolumeCreate (acxelements.h)
La funzione AcxVolumeCreate viene utilizzata per creare un oggetto volume ACX che verrà associato a un oggetto padre dell'oggetto circuito.
Sintassi
NTSTATUS AcxVolumeCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_VOLUME_CONFIG Config,
ACXVOLUME *Volume
);
Parametri
Object
Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti framework) che verrà associato al circuito.
Attributes
Attributi aggiuntivi definiti tramite una struttura WDF_OBJECT_ATTRIBUTES utilizzata per impostare vari valori e per associare l'oggetto volume all'oggetto circuito padre.
Config
Struttura ACX_VOLUME_CONFIG inizializzata che descrive la configurazione dell'oggetto volume.
Volume
Puntatore a una posizione che riceve l'handle per l'oggetto ACXVOLUME appena creato. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Esempio
Di seguito è riportato un esempio di utilizzo.
NTSTATUS status;
WDF_OBJECT_ATTRIBUTES attributes;
ACX_VOLUME_CALLBACKS volumeCallbacks;
ACX_VOLUME_CONFIG volumeCfg;
CODEC_VOLUME_ELEMENT_CONTEXT * volumeCtx;
ACX_VOLUME_CONFIG_INIT(&volumeCfg);
volumeCfg.ChannelsCount = MAX_CHANNELS;
volumeCfg.Minimum = VOLUME_LEVEL_MINIMUM;
volumeCfg.Maximum = VOLUME_LEVEL_MAXIMUM;
volumeCfg.SteppingDelta = VOLUME_STEPPING;
volumeCfg.Callbacks = &volumeCallbacks;
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_VOLUME_ELEMENT_CONTEXT);
attributes.ParentObject = Circuit;
status = AcxVolumeCreate(Circuit, &attributes, &volumeCfg, Element);
Requisiti di ACX
Versione minima di ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxelements.h |
| IRQL | PASSIVE_LEVEL |