AcxFactoryCircuitInitAssignCategories 함수(acxcircuit.h)

  • 아티클

AcxFactoryCircuitInitAssignCategories 함수는 ACXFACTORYCIRCUIT에 대한 GUID(드라이버 범주) 항목 집합을 할당합니다.

구문

NTSTATUS AcxFactoryCircuitInitAssignCategories(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  const GUID              *Categories,
  ULONG                   CategoriesCount
);

매개 변수

FactoryInit

회로 팩터리 초기화에 사용되는 ACXFACTORYCIRCUIT_INIT 구조체입니다. ACX 회로 팩터리 초기화 정보를 저장하고 팩터리를 WDF 디바이스와 연결하는 데 사용되는 불투명 구조체입니다.

AcxFactoryCircuitInitAllocate 함수를 사용하여 ACXFACTORYCIRCUIT_INIT 구조를 초기화합니다.

Categories

원하는 드라이버 범주 항목 집합의 GUID를 포함하는 배열입니다. KSCATERGORY 항목에 대한 자세한 내용은 오디오 어댑터용 디바이스 인터페이스 설치를 참조하세요.

CategoriesCount

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

반환 값

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

설명

이 호출은 ACX에서 초기화된 기본 범주 집합을 재정의합니다.

예제

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

    ACXFACTORYCIRCUIT                               factory;
    PACXFACTORYCIRCUIT_INIT                         factoryInit = NULL;
    SDCAXU_FACTORYCIRCUIT_CONTEXT *                 factoryCtx;
    ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS         operationCallbacks;

    //
    // Get a FactoryCircuitInit structure.
    //
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    AcxFactoryCircuitInitSetComponentId(factoryInit, &SDCAXU_FACTORY_GUID);
    AcxFactoryCircuitInitAssignCategories(factoryInit, &SDCAXU_FACTORY_CATEGORY, 1);

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

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

추가 정보