Funzione NetConfigurationOpenSubConfiguration (netconfiguration.h)
Apre una sottoconfigurazione di un oggetto di configurazione dell'adattatore specificato.
Sintassi
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
Parametri
[_In_] Configuration
Handle per un oggetto di configurazione dell'adattatore aperto in una chiamata precedente a NetAdapterOpenConfiguration o NetConfigurationOpenSubConfiguration.
[_In_] SubConfigurationName
Puntatore a una stringa che specifica il nome della configurazione secondaria da aprire.
[_In_opt_] SubConfigurationAttributes
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_] SubConfiguration
Puntatore a una posizione che riceve un handle per il nuovo oggetto di configurazione secondaria.
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
Se il client fornisce un WDF_OBJECT_ATTRIBUTES, specifica NULL per ParentObject. Per impostazione predefinita, la configurazione secondaria è padre dell'oggetto di configurazione dell'adattatore esistente.
Il driver client chiude la configurazione secondaria chiamando NetConfigurationClose con l'oggetto di configurazione secondario o l'oggetto di configurazione dell'adattatore padre.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.21 |
| Versione UMDF minima | 2.33 |
| Intestazione | netconfiguration.h (include netadaptercx.h) |
| Libreria | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |