共用方式為

EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE回呼函式 （acxcircuit.h）

  • 發行項

驅動程式會使用 EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE 回呼，在 ACX Manager 取消初始化時，執行複合線路的任何取消初始化。

語法

EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EvtAcxCircuitCompositeDeinitialize;

void EvtAcxCircuitCompositeDeinitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CompositeProperties
)
{...}

參數

Device

與指定 ACXCIRCUIT 相關聯的 WDFDEVICE 物件（如 Framework 物件的摘要中所述。

Circuit

正在取消初始化的 ACXCIRCUIT 物件。 如需 ACX 物件的詳細資訊，請參閱 ACX 物件的 摘要。

CompositeProperties

CircuitProperties 的選擇性句柄。 這是 ACXCIRCUIT 屬性的選擇性 ACXOBJECTBAG 物件。

傳回值

沒有

言論

只有在相關聯的 WDFDEVICE 存在時，ACX 才能夠針對複合 ACXCIRCUIT 叫用此回呼。 也就是說，如果相關聯的 WDFDEVICE 遭到意外移除 （SR），ACX 將無法叫用回呼，因為其相關聯的 PnP 介面已關閉。

例

此範例程式代碼示範驅動程式如何從指定的線路屬性物件包擷取線路屬性。

範例使用方式如下所示。

VOID
DspR_EvtCircuitCompositeDeinitialize(
    _In_     WDFDEVICE      Device,
    _In_     ACXCIRCUIT     Circuit,
    _In_opt_ ACXOBJECTBAG   CompositeProperties
    )
{
    DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
    NTSTATUS    status      = STATUS_SUCCESS;
    GUID        uniqueId    = {0};

    PAGED_CODE();

    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    if (CompositeProperties)
    {
        status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);
        if (!NT_SUCCESS(status))
        {
            // Log error.
        }
    }
}

ACX 需求

ACX 最低版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

要求

要求 價值
標頭 acxcircuit.h
IRQL PASSIVE_LEVEL

另請參閱