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

AcxStreamAddElements используется для добавления элементов потока в AcxStream.

Синтаксис

NTSTATUS AcxStreamAddElements(
  ACXSTREAM  Stream,
  ACXELEMENT *Elements,
  ULONG      ElementsCount
);

Параметры

Stream

Существующий объект ACXSTREAM. Объект ACXSTREAM представляет звуковой поток, созданный каналом. Поток может содержать ноль или больше элементов. Дополнительные сведения см. в разделе ACX — сводка по объектам ACX.

Elements

Указатель на массив одного или нескольких существующих объектов ACXELEMENT.

ElementsCount

Количество добавляемых элементов. Это число на основе 1.

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

Возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в использовании значений NTSTATUS.

Замечания

Пример

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

    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, ELEMENT_CONTEXT);
 
    attributes.ParentObject = stream;
    status = AcxElementCreate(stream, &attributes, &elementCfg, &elements[0]);
    elementCtx = GetElementContext(elements[0]);
 
    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, ELEMENT_CONTEXT);
 
    attributes.ParentObject = stream;
    status = AcxElementCreate(stream, &attributes, &elementCfg, &elements[1]);
    elementCtx = GetElementContext(elements[1]);
    //
    // Add stream elements
    //
    status = AcxStreamAddElements(stream, elements, SIZEOF_ARRAY(elements));

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

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

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

Требования

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

См. также

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