EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE Rückruffunktion (acxcircuit.h)
Der EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE Rückruf wird vom Treiber verwendet, um eine zusammengesetzte Verbindung zu initialisieren, wenn sie von ACX Manager erkannt und initialisiert wird.
Syntax
EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EvtAcxCircuitCompositeCircuitInitialize;
NTSTATUS EvtAcxCircuitCompositeCircuitInitialize(
WDFDEVICE Device,
ACXCIRCUIT Circuit,
ACXOBJECTBAG CircuitProperties
)
{...}
Parameter
Device
Ein WDFDEVICE-Objekt (beschrieben in Summary of Framework Objects), das dem angegebenen ACXCIRCUIT zugeordnet ist.
Circuit
Das ACXCIRCUIT-Objekt, das initialisiert wird. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.
CircuitProperties
Optionales Handle für CircuitProperties. Dies ist ein optionales ACXOBJECTBAG-Objekt für die ACXCIRCUIT-Eigenschaften.
Rückgabewert
Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Dieser Beispielcode zeigt, wie der Treiber eine Leitungseigenschaft aus dem angegebenen Leitungseigenschaftsobjektbehälter abruft.
DspR_EvtCircuitCompositeCircuitInitialize(
_In_ WDFDEVICE Device,
_In_ ACXCIRCUIT Circuit,
_In_opt_ ACXOBJECTBAG CircuitProperties
)
{
NTSTATUS status = STATUS_SUCCESS;
PAGED_CODE();
UNREFERENCED_PARAMETER(Device);
UNREFERENCED_PARAMETER(Circuit);
if (CircuitProperties != NULL)
{
DECLARE_CONST_ACXOBJECTBAG_DRIVER_PROPERTY_NAME(msft, TestUI4);
ULONG testUI4;
status = AcxObjectBagRetrieveUI4(CircuitProperties, &TestUI4, &testUI4);
if (!NT_SUCCESS(status))
{
// Log error.
goto exit;
}
//...
}
//...
// All done.
status = STATUS_SUCCESS;
exit:
return status;
}
ACX-Anforderungen
ACX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |