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 |