EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE Rückruffunktion (acxcircuit.h)
Der EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE Rückruf wird vom Treiber verwendet, um jede Initialisierung eines zusammengesetzten Schaltkreises durchzuführen, wenn er vom 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 (in Summary of Framework Objects) beschrieben, das dem angegebenen ACXCIRCUIT zugeordnet ist.
Circuit
Das ACXCIRCUIT-Objekt, das initialisiert wird. Weitere Informationen zu ACX-Objekten finden Sie unter Summary of ACX Objects.
CircuitProperties
Optionaler Handle für CircuitProperties. Dies ist ein optionales ACXOBJECTBAG-Objekt für die Eigenschaften von ACXCIRCUIT.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Dieser Beispielcode zeigt, wie der Treiber eine Schaltkreiseigenschaft aus dem angegebenen Objektbehälter der Schaltkreiseigenschaft 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
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxcircuit.h |
| IRQL- | PASSIVE_LEVEL |