функция обратного вызова EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE (acxcircuit.h)

  • Статья

Обратный вызов EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE используется драйвером для выполнения любой инициализации составного канала при его обнаружении и инициализации диспетчером ACX.

Синтаксис

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EvtAcxCircuitCompositeCircuitInitialize;

NTSTATUS EvtAcxCircuitCompositeCircuitInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CircuitProperties
)
{...}

Параметры

Device

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

Circuit

Инициализируемый объект ACXCIRCUIT. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.

CircuitProperties

Необязательный дескриптор для CircuitProperties. Это необязательный объект ACXOBJECTBAG для свойств ACXCIRCUIT.

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

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

Remarks

Пример

В этом примере кода показано, как драйвер извлекает свойство канала из указанного контейнера объектов свойств цепи.

DspR_EvtCircuitCompositeCircuitInitialize(
    _In_     WDFDEVICE      Device,
    _In_     ACXCIRCUIT     Circuit,
    _In_opt_ ACXOBJECTBAG   CircuitProperties
    )
{
    NTSTATUS status = STATUS_SUCCESS;

    PAGED_CODE();
    
    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    if (CircuitProperties != NULL)
    {
        DECLARE_CONST_ACXOBJECTBAG_DRIVER_PROPERTY_NAME(msft, TestUI4);
        ULONG testUI4;

        status = AcxObjectBagRetrieveUI4(CircuitProperties, &TestUI4, &testUI4);
        if (!NT_SUCCESS(status))
        {
            // Log error.
            goto exit;
        }

        //...
    }
    
    //...

    // All done.
    status = STATUS_SUCCESS;

exit:
    return status;
}

Требования ACX

Минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.

Требования

Требование Значение
Заголовок acxcircuit.h
IRQL PASSIVE_LEVEL

См. также раздел