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 標頭