EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE回呼函式 (acxcircuit.h)
驅動程式會使用 EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE 回呼,在 ACX Manager 偵測並初始化複合線路時執行任何初始化。
語法
EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EvtAcxCircuitCompositeCircuitInitialize;
NTSTATUS EvtAcxCircuitCompositeCircuitInitialize(
WDFDEVICE Device,
ACXCIRCUIT Circuit,
ACXOBJECTBAG CircuitProperties
)
{...}
參數
Device
與指定 ACXCIRCUIT 相關聯的 WDFDEVICE 物件(如 Framework 物件的摘要中所述。
Circuit
正在初始化的 ACXCIRCUIT 物件。 如需 ACX 物件的詳細資訊,請參閱 ACX 物件的 摘要。
CircuitProperties
CircuitProperties 的選擇性句柄。 這是 ACXCIRCUIT 屬性的選擇性 ACXOBJECTBAG 物件。
傳回值
如果呼叫成功,則傳回 STATUS_SUCCESS
。 否則,它會傳回適當的錯誤碼。 如需詳細資訊,請參閱使用NTSTATUS值 。
言論
例
此範例程式代碼示範驅動程式如何從指定的線路屬性物件包擷取線路屬性。
DspR_EvtCircuitCompositeCircuitInitialize(
_In_ WDFDEVICE Device,
_In_ ACXCIRCUIT Circuit,
_In_opt_ ACXOBJECTBAG CircuitProperties
)
{
NTSTATUS status = STATUS_SUCCESS;
PAGED_CODE();
UNREFERENCED_PARAMETER(Device);
UNREFERENCED_PARAMETER(Circuit);
if (CircuitProperties != NULL)
{
DECLARE_CONST_ACXOBJECTBAG_DRIVER_PROPERTY_NAME(msft, TestUI4);
ULONG testUI4;
status = AcxObjectBagRetrieveUI4(CircuitProperties, &TestUI4, &testUI4);
if (!NT_SUCCESS(status))
{
// Log error.
goto exit;
}
//...
}
//...
// All done.
status = STATUS_SUCCESS;
exit:
return status;
}
ACX 需求
ACX 最低版本: 1.0
如需 ACX 版本的詳細資訊,請參閱 ACX 版本概觀。
要求
要求 | 價值 |
---|---|
標頭 | acxcircuit.h |
IRQL | PASSIVE_LEVEL |