共用方式為


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

與指定 ACXCIRCUIT 相關聯的 架構物件 摘要) 中所述的 WDFDEVICE 物件 (。

Circuit

要初始化的 ACXCIRCUIT 物件。 如需 ACX 對象的詳細資訊,請參閱 ACX 物件的摘要

CompositeProperties

描述復合線路之 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
IRQL PASSIVE_LEVEL

另請參閱