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

回線に追加されるカテゴリの数。 これは 1 から始まるカウントです。

戻り値

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 バージョンの概要」を参照してください。

要件

要件	値
Header	acxcircuit.h
IRQL	PASSIVE_LEVEL

こちらもご覧ください

• acxcircuit.h ヘッダー