acxTargetCircuitCreate 函式 (acxtargets.h)
AcxTargetCircuitCreate 函式是用來建立 ACX 目標線路。
語法
NTSTATUS AcxTargetCircuitCreate(
WDFDEVICE Device,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_TARGET_CIRCUIT_CONFIG Config,
ACXTARGETCIRCUIT *TargetCircuit
);
參數
Device
與指定 ACXCIRCUIT 相關聯的 Framework 物件摘要) 中所述的 WDFDEVICE 物件 (。
Attributes
使用用來設定各種物件值 之WDF_OBJECT_ATTRIBUTES 結構定義的其他屬性：清除和終結回呼、內容類型，以及指定其父物件。
Config
描述目標線路組態的初始化 ACX_TARGET_CIRCUIT_CONFIG結構 。
TargetCircuit
接收新 ACXTARGETCIRCUIT 物件句柄的位置指標。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。
傳回值
如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。
備註
範例
ACX_TARGET_CIRCUIT_CONFIG targetCfg;
ACX_TARGET_CIRCUIT_CONFIG_INIT(&targetCfg);
targetCfg.SymbolicLinkName = link;
WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.ParentObject = Circuit;
RETURN_NTSTATUS_IF_FAILED(AcxTargetCircuitCreate(AcxCircuitGetWdfDevice(Circuit), &attributes, &targetCfg, TargetCircuit));
ACX 需求
最小 ACX 版本： 1.0
如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | acxtargets.h |
| IRQL | PASSIVE_LEVEL |