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

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

Синтаксис

ACXELEMENT AcxStreamGetElementById(
  ACXSTREAM Stream,
  ULONG     ElementId
);

Параметры

Stream

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

ElementId

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

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

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

Remarks

Пример

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

    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

См. также раздел