AcxTargetCircuitCreate-Funktion (acxtargets.h)

Die AcxTargetCircuitCreate-Funktion wird verwendet, um eine ACX-Zielschaltung zu erstellen.

Syntax

NTSTATUS AcxTargetCircuitCreate(
  WDFDEVICE                  Device,
  PWDF_OBJECT_ATTRIBUTES     Attributes,
  PACX_TARGET_CIRCUIT_CONFIG Config,
  ACXTARGETCIRCUIT           *TargetCircuit
);

Parameter

Device

Ein WDFDEVICE-Objekt (in Summary of Framework Objects) beschrieben, das dem angegebenen ACXCIRCUIT zugeordnet ist.

Attributes

Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES Struktur definiert werden, die zum Festlegen der Werte verschiedener Objekte verwendet werden: Bereinigen und Zerstören von Rückrufen, Kontexttyp und Angeben des übergeordneten Objekts.

Config

Eine initialisierte ACX_TARGET_CIRCUIT_CONFIG Struktur, die die Konfiguration der Zielschaltung beschreibt.

TargetCircuit

Ein Zeiger auf eine Position, die ein Handle zum neuen ACXTARGETCIRCUIT-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter Summary of ACX Objects.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Beispiel

    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-Anforderungen

Mindestens ACX-Version: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Siehe auch

• acxtargets.h-Header