AcxElementCreate, fonction (acxelements.h)
La fonction AcxElementCreate permet de créer un objet ACXELEMENT qui sera associé à un parent d’objet d’appareil de circuit ou de flux.
Syntaxe
NTSTATUS AcxElementCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_ELEMENT_CONFIG Config,
ACXELEMENT *Element
);
Paramètres
Object
Objet WDFDEVICE (décrit dans Résumé des objets framework) qui sera associé au flux ou au circuit.
Attributes
Attributs supplémentaires définis à l’aide d’une structure de WDF_OBJECT_ATTRIBUTES qui sont utilisés pour définir diverses valeurs et associer l’élément ACX au flux parent ou à l’objet circuit.
Config
Structure ACX_ELEMENT_CONFIG initialisée qui décrit la configuration de l’élément.
Element
Pointeur vers un emplacement qui reçoit le handle de l’objet ACXELEMENT nouvellement créé. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.
Valeur retournée
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.
Remarques
Exemple
L’exemple d’utilisation est illustré ci-dessous.
NTSTATUS status;
WDF_OBJECT_ATTRIBUTES attributes;
ACXSTREAM stream;
ACXELEMENT elements[2] = {0};
ACX_ELEMENT_CONFIG elementCfg;
CODEC_ELEMENT_CONTEXT * elementCtx;
ACX_ELEMENT_CONFIG_INIT(&elementCfg);
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ELEMENT_CONTEXT);
attributes.ParentObject = stream;
status = AcxElementCreate(stream, &attributes, &elementCfg, &elements[0]);
Configuration requise pour ACX
Version ACX minimale : 1.0
Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | acxelements.h |
| IRQL | PASSIVE_LEVEL |