共用方式為


EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE回呼函式 (acxcircuit.h)

當驅動程式必須刪除與 ACXCIRCUIT 對象相關聯的先前建立 WDFDEVICE 時,ACX 會叫用 EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE 回呼。

語法

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;

NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
  WDFDEVICE Parent,
  ACXFACTORYCIRCUIT Factory,
  WDFDEVICE Device
)
{...}

參數

Parent

WDFDEVICE 物件 (說明於 Framework 物件的摘要) ,這是 Device 物件中所參考之 WDFDEVICE 的父代。

Factory

現有的線路處理站 ACXFACTORYCIRCUIT 物件。 如需 ACX 對象的詳細資訊,請參閱 ACX 物件的摘要

Device

必須刪除 的 Framework 物件 摘要) 中所述的 WDFDEVICE 物件 (。

傳回值

如果呼叫成功,則傳 STATUS_SUCCESS 回 。 否則,它會傳回適當的錯誤碼。 如需詳細資訊,請參閱 使用NTSTATUS值

備註

AcxFactoryCircuit 代表能夠視需要建立 ACXCIRCUIT 的 Factory 物件。

驅動程式可以使用 ACX 註冊一或多個 ACXFACTORYCIRCUIT,此動作會讓 ACX 知道驅動程式能夠建立定義完善的類型 ACXCIRCUIT。

ACX 會在偵測到音訊路徑需要其中一個原廠提供的 ACXCIRCUIT 時,叫用 ACXFACTORYCIRCUIT 的回呼。

如果未定義EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE回呼,這是選擇性回呼,ACX 會採取預設動作,從列舉裝置清單中移除指定的 WDFDEVICE。 此動作會觸發子 WDFDEVICE 的意外移除 PnP 通知。

ACXFACTORYCIRCUIT 對象支援動態 ACXCIRCUIT,這表示處理站所建立的每個 ACXCIRCUIT 都與 WDFDEVICE 相關聯,而且這兩個物件具有相同的存留期。

AcxFactoryCircuit 有專用的 WDF 佇列。 如需 WDF 佇列的詳細資訊,請參閱 Framework Queue Objects

ACX 需求

最低 ACX 版本: 1.0

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

規格需求

需求
標頭 acxcircuit.h
IRQL PASSIVE_LEVEL

另請參閱