Функция AcxTargetCircuitCreate (acxtargets.h)

Статья
02/26/2024

Функция AcxTargetCircuitCreate используется для создания целевого канала ACX.

Синтаксис

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

Параметры

Device

Объект WDFDEVICE ( описанный в разделе Сводка по объектам платформы), связанный с указанным ACXCIRCUIT.

Attributes

Дополнительные атрибуты, определенные с помощью WDF_OBJECT_ATTRIBUTES структуры, которая используется для задания различных значений объекта: очистки и уничтожения обратных вызовов, типа контекста и указания его родительского объекта.

Config

Инициализированная структура ACX_TARGET_CIRCUIT_CONFIG , описывающая конфигурацию целевого канала.

TargetCircuit

Указатель на расположение, которое получает дескриптор нового объекта ACXTARGETCIRCUIT. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.

Возвращаемое значение

Возвращает значение STATUS_SUCCESS , если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.

Remarks

Пример

    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

Поделиться через