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 標頭