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 |