Freigeben über


AcxStreamGetElementById-Funktion (acxstreams.h)

Die AcxStreamGetElementById--Funktion gibt das ACXELEMENT-Objekthandle für die angeforderte Element-ID zurück. Weitere Informationen zu ACX-Objekten finden Sie unter ACX – Zusammenfassung von ACX Objects.

Syntax

ACXELEMENT AcxStreamGetElementById(
  ACXSTREAM Stream,
  ULONG     ElementId
);

Parameter

Stream

Ein vorhandenes ACXSTREAM-Objekt. Ein ACXSTREAM -Objekt stellt einen Von einem Schaltkreis erstellten Audiodatenstrom dar.

ElementId

Die ID des angeforderten Elements.

Rückgabewert

Das ACXELEMENT-Objekthandle des angeforderten Elements oder NULL, wenn acXSTREAM kein ACXELEMENT mit der angegebenen ID aufweist.

Bemerkungen

Beispiel

Die Beispielverwendung wird unten gezeigt.

    ULONGLONG               index       = GetMessageContext(Event); // Context is an index.
    ACXELEMENT              element     = nullptr;
    //
    // Get the ACX element.
    //
    element = AcxStreamGetElementById(Stream, (ULONG)index);

ACX-Anforderungen

Mindestens ACX-Version: 1.0

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

Anforderungen

Anforderung Wert
Header- acxstreams.h
IRQL- <= DISPATCH_LEVEL

Siehe auch