EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE回调函数 (acxcircuit.h)
EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE回调由驱动程序用于在 ACX Manager 组装复合终结点后执行任何后初始化。
语法
EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE EvtAcxCircuitCompositeInitialize;
NTSTATUS EvtAcxCircuitCompositeInitialize(
WDFDEVICE Device,
ACXCIRCUIT Circuit,
ACXOBJECTBAG CompositeProperties
)
{...}
参数
Device
WDFDEVICE 对象 (与指定的 ACXCIRCUIT 关联的 框架对象) 摘要 中所述。
Circuit
正在初始化的 ACXCIRCUIT 对象。 有关 ACX 对象的详细信息，请参阅 ACX 对象的摘要。
CompositeProperties
描述复合线路的 CompositeProperties 的可选句柄。 这是复合终结点属性的可选 ACXOBJECTBAG 对象。
返回值
STATUS_SUCCESS如果调用成功，则返回 。 否则，它将返回相应的错误代码。 有关详细信息，请参阅 使用 NTSTATUS 值。
备注
示例
此示例代码演示驱动程序如何从指定的复合属性对象包中检索复合属性。
EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE CodecR_EvtCircuitCompositeInitialize;
NTSTATUS
CodecR_EvtCircuitCompositeInitialize(
_In_ WDFDEVICE Device,
_In_ ACXCIRCUIT Circuit,
_In_ ACXOBJECTBAG CompositeProperties
)
{
PAGED_CODE();
NTSTATUS status = STATUS_SUCCESS;
UNREFERENCED_PARAMETER(Device);
UNREFERENCED_PARAMETER(Circuit);
ASSERT(CompositeProperties);
DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
GUID uniqueId = {0};
status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);
// ...
return status;
}
ACX 要求
最低 ACX 版本： 1.0
有关 ACX 版本的详细信息，请参阅 ACX 版本概述。
要求
| 要求 | 值 |
|---|---|
| Header | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |