EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE回呼函式 (acxcircuit.h)
驅動程式會使用 EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE 回呼,在 ACX 管理員組合複合端點之後執行任何後續初始化。
語法
EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE EvtAcxCircuitCompositeInitialize;
NTSTATUS EvtAcxCircuitCompositeInitialize(
WDFDEVICE Device,
ACXCIRCUIT Circuit,
ACXOBJECTBAG CompositeProperties
)
{...}
參數
Device
與指定 ACXCIRCUIT 相關聯的 架構物件 摘要) 中所述的 WDFDEVICE 物件 (。
Circuit
要初始化的 ACXCIRCUIT 物件。 如需 ACX 對象的詳細資訊,請參閱 ACX 物件的摘要。
CompositeProperties
描述復合線路之 CompositeProperties 的選擇性句柄。 這是複合端點屬性的選擇性 ACXOBJECTBAG 物件。
傳回值
如果呼叫成功,則傳 STATUS_SUCCESS
回 。 否則,它會傳回適當的錯誤碼。 如需詳細資訊,請參閱 使用NTSTATUS值。
備註
範例
此範例程式代碼示範驅動程式如何從指定的複合屬性物件包擷取複合屬性。
EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE CodecR_EvtCircuitCompositeInitialize;
NTSTATUS
CodecR_EvtCircuitCompositeInitialize(
_In_ WDFDEVICE Device,
_In_ ACXCIRCUIT Circuit,
_In_ ACXOBJECTBAG CompositeProperties
)
{
PAGED_CODE();
NTSTATUS status = STATUS_SUCCESS;
UNREFERENCED_PARAMETER(Device);
UNREFERENCED_PARAMETER(Circuit);
ASSERT(CompositeProperties);
DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
GUID uniqueId = {0};
status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);
// ...
return status;
}
ACX 需求
最低 ACX 版本: 1.0
如需 ACX 版本的詳細資訊,請參閱 ACX 版本概觀。
規格需求
需求 | 值 |
---|---|
標頭 | acxcircuit.h |
IRQL | PASSIVE_LEVEL |