Share via


Función AcxTargetCircuitCreate (acxtargets.h)

La función AcxTargetCircuitCreate se usa para crear un circuito de destino ACX.

Sintaxis

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

Parámetros

Device

Objeto WDFDEVICE (descrito en Resumen de objetos de marco) asociado al ACXCIRCUIT especificado.

Attributes

Atributos adicionales definidos mediante una estructura de WDF_OBJECT_ATTRIBUTES que se usan para establecer los valores de varios objetos: limpieza y destrucción de devoluciones de llamada, tipo de contexto y para especificar su objeto primario.

Config

Estructura de ACX_TARGET_CIRCUIT_CONFIG inicializada que describe la configuración del circuito de destino.

TargetCircuit

Puntero a una ubicación que recibe un identificador para el nuevo objeto ACXTARGETCIRCUIT. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Ejemplo

    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));

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxtargets.h
IRQL PASSIVE_LEVEL

Consulte también