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

另請參閱

• acxtargets.h 標頭