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 的 GUIDS，例如 KSCATEGORY_AUDIO。 如需 KSCATERGORY 專案的詳細資訊，請參閱 安裝音訊配接器的裝置介面。
CategoriesCount
將新增至線路的類別數目。 這是一個以計數為基礎的計數。
傳回值
如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。
備註
此呼叫會覆寫 ACX 所初始化的預設類別集，此類別集是以 ACXCIRCUIT 類型為基礎。
範例
範例使用方式如下所示。
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 |