Funzione NetConfigurationOpenSubConfiguration (netconfiguration.h)

Apre una configurazione secondaria 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 a un oggetto di configurazione della scheda 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 contenente 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 della scheda esistente.

Il driver client chiude la configurazione secondaria chiamando NetConfigurationClose con l'oggetto di configurazione secondaria o l'oggetto di configurazione della scheda padre.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.21
Intestazione	netconfiguration.h (include netadaptercx.h)
Libreria	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Vedi anche

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration