Функция AcxStreamGetElementById (acxstreams.h)

Статья
02/06/2025

Функция AcxStreamGetElementById возвращает дескриптор объекта ACXELEMENT для запрошенного идентификатора элемента. Дополнительные сведения о объектах ACX см. в ACX — сводка по объектам ACX.

Синтаксис

ACXELEMENT AcxStreamGetElementById(
  ACXSTREAM Stream,
  ULONG     ElementId
);

Параметры

Stream

Существующий объект ACXSTREAM. Объект ACXSTREAM представляет звуковой поток, созданный каналом.

ElementId

Идентификатор запрошенного элемента.

Возвращаемое значение

Дескриптор объекта ACXELEMENT запрошенного элемента или NULL, если ACXSTREAM не имеет ACXELEMENT с заданным идентификатором.

Замечания

Пример

Ниже показан пример использования.

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

Требования к ACX

минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в обзоре версий ACX.

Требования

Требование	Ценность
заголовка	acxstreams.h
IRQL	<= DISPATCH_LEVEL

См. также

заголовка acxstreams.h

Поделиться через