Funzione NetDeviceOpenConfiguration (netdevice.h)
La funzione NetDeviceOpenConfiguration apre il database di configurazione di un dispositivo net.
Sintassi
NTSTATUS NetDeviceOpenConfiguration(
[_In_] WDFDEVICE Device,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
[_Out_] NETCONFIGURATION *Configuration
);
Parametri
[_In_] Device
Oggetto WDFDEVICE creato in precedenza con una chiamata a WdfDeviceCreate.
[_In_opt_] ConfigurationAttributes
Puntatore a una struttura WDF_OBJECT_ATTRIBUTES che contiene gli attributi forniti dal driver per il nuovo oggetto di configurazione. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.
[_Out_] Configuration
Puntatore alla posizione che riceve il nuovo oggetto NETCONFIGURATION.
Valore restituito
Questa funzione restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione può restituire un codice di errore NTSTATUS appropriato.
Osservazioni
In genere, il client chiama questa funzione dalla relativa funzione di callback EVT_WDF_DRIVER_DEVICE_ADD.
Se il client fornisce un WDF_OBJECT_ATTRIBUTES, specifica NULL per ParentObject. L'oggetto di configurazione del dispositivo viene automaticamente padre dell'oggetto dispositivo.
Di conseguenza, WDF elimina automaticamente l'oggetto di configurazione quando il dispositivo viene eliminato. Tuttavia, il client può eliminare manualmente un oggetto di configurazione chiamando WdfObjectDelete, in genere dalla relativa funzione di callback EVT_WDF_OBJECT_CONTEXT_CLEANUP.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.27 |
| versione minima di UMDF | 2.33 |
| intestazione | netdevice.h (include netadaptercx.h) |
| libreria | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |