AcxCircuitInitAssignCategories 함수(acxcircuit.h)

  • 아티클

AcxCircuitInitAssignCategories 함수는 ACXCIRCUIT에 대한 KSCATERGORY 항목 집합을 할당합니다.

구문

NTSTATUS AcxCircuitInitAssignCategories(
  PACXCIRCUIT_INIT CircuitInit,
  const GUID       *Categories,
  ULONG            CategoriesCount
);

매개 변수

CircuitInit

회로 초기화를 정의하는 ACXCIRCUIT_INIT 구조체입니다. ACXCIRCUIT_INIT 회로 초기화에 사용되는 불투명 개체입니다. AcxCircuitInitAllocate를 사용하여 ACXCIRCUIT_INIT 구조를 초기화합니다.

Categories

원하는 KSCATERGORY의 GUID가 들어 있는 배열입니다(예 KSCATEGORY_AUDIO: ). KSCATERGORY 항목에 대한 자세한 내용은 오디오 어댑터용 디바이스 인터페이스 설치를 참조하세요.

CategoriesCount

회로에 추가될 범주 수입니다. 이는 하나의 기반 개수입니다.

반환 값

호출에 성공하면 를 반환합니다 STATUS_SUCCESS . 그렇지 않으면 적절한 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값 사용을 참조하세요.

설명

이 호출은 ACXCIRCUIT 형식을 기반으로 하는 ACX에서 초기화된 기본 범주 집합을 재정의합니다.

예제

예제 사용법은 다음과 같습니다.


    GUID captureCategories[] =
    {
        STATICGUIDOF(KSCATEGORY_AUDIO),
        STATICGUIDOF(KSCATEGORY_CAPTURE), 
        STATICGUIDOF(KSCATEGORY_REALTIME),
        STATICGUIDOF(KSCATEGORY_TOPOLOGY),
    };

    //
    // Add circuit identifiers.
    //
    AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);

    AcxCircuitInitAssignName(CircuitInit, &circuitName);

    status = AcxCircuitInitAssignCategories(CircuitInit, captureCategories, SIZEOF_ARRAY(captureCategories));

ACX 요구 사항

최소 ACX 버전: 1.0

ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.

요구 사항

요구 사항 값
헤더 acxcircuit.h
IRQL PASSIVE_LEVEL

추가 정보