Funzione NetDeviceOpenConfiguration (netdevice.h)

La funzione NetDeviceOpenConfiguration apre un 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

L'oggetto WDFDEVICE il driver client creato in precedenza con una chiamata a WdfDeviceCreate.

[_In_opt_] ConfigurationAttributes

Puntatore a una struttura WDF_OBJECT_ATTRIBUTES contenente attributi forniti dal driver per il nuovo oggetto di configurazione. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Configuration

Puntatore al percorso 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.

Commenti

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 padreato all'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 .

Requisiti

Vedi anche

Accesso alle informazioni di configurazione