Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La funzione NetAdapterOpenConfiguration apre un database di configurazione di net adapter.
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 NetAdapterCreare.
[_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 a una posizione che riceve un handle per il nuovo oggetto di configurazione dell'adattatore.
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.
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 dell'adapter viene automaticamente padre dell'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.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.21 |
| versione minima di UMDF | 2.33 |
| intestazione | netadapter.h (include netadaptercx.h) |
| libreria | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |