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

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

  • Статья

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

Синтаксис

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE EvtAcxCircuitCompositeInitialize;

NTSTATUS EvtAcxCircuitCompositeInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CompositeProperties
)
{...}

Параметры

Device

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

Circuit

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

CompositeProperties

Необязательный дескриптор CompositeProperties, описывающий составной канал. Это необязательный объект ACXOBJECTBAG для свойств составной конечной точки.

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

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

Remarks

Пример

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

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE CodecR_EvtCircuitCompositeInitialize;

NTSTATUS
CodecR_EvtCircuitCompositeInitialize(
    _In_ WDFDEVICE      Device,
    _In_ ACXCIRCUIT     Circuit,
    _In_ ACXOBJECTBAG   CompositeProperties
    )
{
    PAGED_CODE();

    NTSTATUS status = STATUS_SUCCESS;

    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    ASSERT(CompositeProperties);

    DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
    GUID uniqueId = {0};
    status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);

    // ...

    return status;
}

Требования к ACX

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

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

Требования

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

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