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

另請參閱

• acxcircuit.h 標頭