Funzione AcxTargetCircuitCreate (acxtargets.h)
La funzione AcxTargetCircuitCreate viene usata per creare un circuito di destinazione ACX.
Sintassi
NTSTATUS AcxTargetCircuitCreate(
WDFDEVICE Device,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_TARGET_CIRCUIT_CONFIG Config,
ACXTARGETCIRCUIT *TargetCircuit
);
Parametri
Device
Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti framework) associato all'oggetto ACXCIRCUIT specificato.
Attributes
Attributi aggiuntivi definiti usando una struttura WDF_OBJECT_ATTRIBUTES utilizzata per impostare i valori di vari oggetti: pulizia ed eliminazione definitiva di callback, tipo di contesto e per specificare il relativo oggetto padre.
Config
Struttura ACX_TARGET_CIRCUIT_CONFIG inizializzata che descrive la configurazione del circuito di destinazione.
TargetCircuit
Puntatore a una posizione che riceve un handle per il nuovo oggetto ACXTARGETCIRCUIT. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Esempio
ACX_TARGET_CIRCUIT_CONFIG targetCfg;
ACX_TARGET_CIRCUIT_CONFIG_INIT(&targetCfg);
targetCfg.SymbolicLinkName = link;
WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.ParentObject = Circuit;
RETURN_NTSTATUS_IF_FAILED(AcxTargetCircuitCreate(AcxCircuitGetWdfDevice(Circuit), &attributes, &targetCfg, TargetCircuit));
Requisiti di ACX
Versione minima di ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxtargets.h |
| IRQL | PASSIVE_LEVEL |