AcxFactoryCircuitInitAssignMethods 函数 (acxcircuit.h)
AcxFactoryCircuitInitAssignMethods 函数为 ACXFACTORYCIRCUIT 分配一个或多个 ACX 方法。
语法
NTSTATUS AcxFactoryCircuitInitAssignMethods(
PACXFACTORYCIRCUIT_INIT FactoryInit,
PACX_METHOD_ITEM Methods,
ULONG MethodsCount
);
参数
FactoryInit
用于线路工厂初始化的ACXFACTORYCIRCUIT_INIT结构。 这是一种不透明结构，用于存储 ACX 线路工厂初始化信息并将工厂与 WDF 设备相关联。 使用 AcxFactoryCircuitInitAllocate 函数 初始化 ACXFACTORYCIRCUIT_INIT 结构。
Methods
定义将用于线路初始化的一组方法的 ACX_METHOD_ITEM 结构。
MethodsCount
将分配给线路的方法数。 这是一个基于 1 的计数。
返回值
STATUS_SUCCESS如果调用成功，则返回 。 否则，它将返回相应的错误代码。 有关详细信息，请参阅 使用 NTSTATUS 值。
注解
驱动程序应仅添加驱动程序拥有的方法。
示例
示例用法如下所示。
typedef enum {
KSMETHOD_APXCIRCUITFACTORY_ADD_CIRCUIT = 1,
KSMETHOD_APXCIRCUITFACTORY_REMOVE_CIRCUIT = 2,
} KSMETHOD_APXCIRCUITFACTORY;
static ACX_METHOD_ITEM s_FactoryCircuitMethods[] =
{
{
&KSMETHODSETID_ApxCircuitFactory,
KSMETHOD_APXCIRCUITFACTORY_ADD_CIRCUIT,
ACX_METHOD_ITEM_FLAG_SEND,
&C_EvtAddCircuitCallback,
NULL, // Reserved
sizeof(APX_CIRCUIT_FACTORY_ADD_CIRCUIT), // ControlCb
0, // ValueCb
},
/*
{
&KSMETHODSETID_ApxCircuitFactory,
KSMETHOD_APXCIRCUITFACTORY_REMOVE_CIRCUIT,
ACX_METHOD_ITEM_FLAG_SEND,
&EvtRemoveCircuitCallback,
NULL, // Reserved
sizeof(APX_CIRCUIT_FACTORY_REMOVE_CIRCUIT), // ControlCb
0, // ValueCb
},
*/
};
//
// Get a FactoryCircuitInit structure.
//
factoryInit = AcxFactoryCircuitInitAllocate(Device);
//
// Add factory identifiers.
//
AcxFactoryCircuitInitSetComponentId(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY);
AcxFactoryCircuitInitAssignCategories(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY, 1);
AcxFactoryCircuitInitAssignName(factoryInit, &s_FactoryName);
//
// Add properties, events and methods.
//
status = AcxFactoryCircuitInitAssignMethods(factoryInit,
s_FactoryCircuitMethods,
s_FactoryCircuitMethodsCount);
ACX 要求
最低 ACX 版本： 1.0
有关 ACX 版本的详细信息，请参阅 ACX 版本概述。
要求
| 要求 | 值 |
|---|---|
| Header | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |