Share via

Fungsi AcxTargetCircuitGetTargetElement (acxtargets.h)

  • Artikel

Fungsi AcxTargetCircuitGetTargetElement , mengingat nilai indeks elemen yang valid, akan mengembalikan objek ACXTARGETELEMENT terkait.

Sintaks

ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG            ElementIndex
);

Parameter

TargetCircuit

Handel ACXTARGETCIRCUIT. Untuk informasi selengkapnya tentang objek ACX, lihat Ringkasan Objek ACX.

ElementIndex

Nilai indeks elemen yang valid.

Menampilkan nilai

Mengembalikan Objek ACXTARGETELEMENT ACX yang terkait dengan sirkuit yang ditentukan.

Keterangan

Contoh

    // 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;
        }
    }

Persyaratan ACX

Versi ACX minimum: 1.0

Untuk informasi selengkapnya tentang versi ACX, lihat Gambaran umum versi ACX.

Persyaratan

Persyaratan Nilai
Header acxtargets.h
IRQL <= DISPATCH_LEVEL

Lihat juga