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

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

戻り値

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

要件

要件 値
Header acxcircuit.h
IRQL PASSIVE_LEVEL

こちらもご覧ください