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 |