Função NetConfigurationOpenSubConfiguration (netconfiguration.h)
Abre uma subconsulta de um objeto de configuração de adaptador especificado.
Sintaxe
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
Parâmetros
[_In_] Configuration
Um identificador para um objeto de configuração do adaptador aberto em uma chamada anterior para netAdapterOpenConfiguration ou NetConfigurationOpenSubConfiguration.
[_In_] SubConfigurationName
Um ponteiro para uma cadeia de caracteres que especifica o nome da subconsulta a ser aberta.
[_In_opt_] SubConfigurationAttributes
Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que contém atributos fornecidos pelo driver para o novo objeto de configuração. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.
[_Out_] SubConfiguration
Um ponteiro para um local que recebe um identificador para o novo objeto de subconsulta.
Valor de retorno
A função retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função poderá retornar um código de erro NTSTATUS apropriado.
Observações
Se o cliente fornecer um WDF_OBJECT_ATTRIBUTES, ele especifica NULL para ParentObject. Por padrão, a subconsulta é pai do objeto de configuração do adaptador existente.
O driver cliente fecha a subconfiguração chamando NetConfigurationClose com o objeto de subconfiguração ou o objeto de configuração do adaptador pai.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.21 |
| versão mínima do UMDF | 2.33 |
| cabeçalho | netconfiguration.h (include netadaptercx.h) |
| biblioteca | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |