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

Функция 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.

Замечания

Пример

    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

См. также

  • Last updated on