Funzione NetAdapterOpenConfiguration (netadapter.h)

La funzione NetAdapterOpenConfiguration apre il database di configurazione di una scheda net.

Sintassi

NTSTATUS NetAdapterOpenConfiguration(
  [_In_]     NETADAPTER            Adapter,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Parametri

[_In_] Adapter

Oggetto scheda di rete creato dal client in una chiamata precedente a NetAdapterCreate.

[_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 a un percorso che riceve un handle per il nuovo oggetto di configurazione della scheda.

Valore restituito

La 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 dell'adapter viene padre automatico all'oggetto adapter.

Di conseguenza, WDF elimina automaticamente l'oggetto di configurazione quando l'adapter 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

NetConfigurationClose