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 |