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 Objects摘要中所述),這是 Device 物件中所參考 WDFDEVICE 的父代。
Factory
現有的線路處理站 ACXFACTORYCIRCUIT 物件。 如需 ACX 物件的詳細資訊,請參閱 ACX 物件的 摘要。
Device
必須刪除的 WDFDEVICE 物件(如 Framework 物件的摘要中所述。
傳回值
如果呼叫成功,則傳回 STATUS_SUCCESS
。 否則,它會傳回適當的錯誤碼。 如需詳細資訊,請參閱使用NTSTATUS值 。
言論
AcxFactoryCircuit 代表能夠視需要建立 ACXCIRCUIT 的 Factory 物件。
驅動程式可以向 ACX 註冊一或多個 ACXFACTORYCIRCUIT,此動作會讓 ACX 知道驅動程式能夠建立定義完善的 ACXCIRCUIT。
當 ACX 偵測到音訊路徑需要其中一個提供 ACXCIRCUIT 的處理站時,ACX 會叫用 ACXFACTORYCIRCUIT 的回呼。
如果未定義EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE回呼,這是選擇性回呼,ACX 會採取預設動作,從列舉裝置清單中移除指定的 WDFDEVICE。 此動作會觸發子 WDFDEVICE 的意外移除 PnP 通知。
ACXFACTORYCIRCUIT 對象支援動態 ACXCIRCUIT,這表示 Factory 所建立的每個 ACXCIRCUIT 都會與 WDFDEVICE 相關聯,而且這兩個物件具有相同存留期。
AcxFactoryCircuit 有專用的 WDF 佇列。 如需 WDF 佇列的詳細資訊,請參閱 Framework Queue Objects。
ACX 需求
ACX 最低版本: 1.0
如需 ACX 版本的詳細資訊,請參閱 ACX 版本概觀。
要求
要求 | 價值 |
---|---|
標頭 | acxcircuit.h |
IRQL | PASSIVE_LEVEL |