AcxElementCreate-Funktion (acxelements.h)

  • Artikel

Die AcxElementCreate-Funktion wird verwendet, um ein ACXELEMENT-Objekt zu erstellen, das einem übergeordneten Leitungs- oder Streamgeräteobjekt zugeordnet wird.

Syntax

NTSTATUS AcxElementCreate(
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_ELEMENT_CONFIG    Config,
  ACXELEMENT             *Element
);

Parameter

Object

Ein WDFDEVICE-Objekt (beschrieben in Zusammenfassung der Frameworkobjekte), das dem Datenstrom oder der Verbindung zugeordnet wird.

Attributes

Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES-Struktur definiert werden, die verwendet werden, um verschiedene Werte festzulegen und das ACX-Element dem übergeordneten Stream oder Leitungsobjekt zuzuordnen.

Config

Eine initialisierte ACX_ELEMENT_CONFIG Struktur , die die Konfiguration des Elements beschreibt.

Element

Ein Zeiger auf einen Speicherort, der das Handle zum neu erstellten ACXELEMENT-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.

Rückgabewert

Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt.

    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]);

ACX-Anforderungen

ACX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxelements.h
IRQL PASSIVE_LEVEL

Weitere Informationen