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


Функция AcxTargetCircuitGetTargetElement (acxtargets.h)

Функция AcxTargetCircuitGetTargetElement с допустимым значением индекса элемента вернет связанный объект ACXTARGETELEMENT.

Синтаксис

ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG            ElementIndex
);

Параметры

TargetCircuit

Дескриптор ACXTARGETCIRCUIT. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.

ElementIndex

Допустимое значение индекса элемента.

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

Возвращает объект ACXTARGETELEMENT ACX, связанный с указанным каналом.

Remarks

Пример

    // Search the target circuit for a volume element.
    // This sample code doesn't support downstream audioengine elements.
    // 
    for (ULONG elementIndex = 0; elementIndex < AcxTargetCircuitGetElementsCount(TargetCircuit); ++elementIndex)
    {
        ACXTARGETELEMENT targetElement = AcxTargetCircuitGetTargetElement(TargetCircuit, elementIndex);
        GUID elementType = AcxTargetElementGetType(targetElement);

        if (IsEqualGUID(elementType, KSNODETYPE_VOLUME) &&
            circuitCtx->TargetVolumeHandler == nullptr)
        {
            // Found Volume
            circuitCtx->TargetVolumeHandler = targetElement;
        }
    }

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

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

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

Требования

Требование Значение
Заголовок acxtargets.h
IRQL <= DISPATCH_LEVEL

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