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 |