функция обратного вызова 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

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

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

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

Замечания

Пример

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

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