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 |