Função IoGetDriverProxyFeatures (wdm.h)

A função IoGetDriverProxyFeatures obtém os sinalizadores de recurso DriverProxy para o sistema atual e o driver especificado.

Essa função permite que os drivers determinem se a funcionalidade DriverProxy está disponível e habilitada para sua instância de driver específica. O DriverProxy permite a funcionalidade de driver de hot-swappable, permitindo que os drivers registrem funções de ponto de extremidade que podem ser substituídas no runtime sem descarregar o driver.

Sintaxe

VOID IoGetDriverProxyFeatures(
  PDRIVER_OBJECT              DriverObject,
  PDRIVER_PROXY_FEATURE_FLAGS Flags
);

Parâmetros

DriverObject

[in, opcional] Um ponteiro opcional para o DRIVER_OBJECT para verificar se há suporte ao DriverProxy. Se esse parâmetro for NULL, a função verificará se o DriverProxy está habilitado para todos os drivers no sistema.

Flags

[out] Um ponteiro para uma estrutura de DRIVER_PROXY_FEATURE_FLAGS que recebe os sinalizadores de recurso DriverProxy. A estrutura indica se a funcionalidade DriverProxy está disponível e habilitada.

Valor de retorno

Essa função não retorna um valor.

Observações

A função IoGetDriverProxyFeatures determina a disponibilidade do DriverProxy com base em vários fatores:

• Se o sistema dá suporte à funcionalidade DriverProxy
• Se o Kernel Seguro está em execução (necessário para DriverProxy)
• Se o driver específico é excluído das operações do DriverProxy por meio de configurações do Registro
• Se o DriverProxy foi desabilitado globalmente

Os drivers devem chamar essa função antes de tentar usar outras APIs DriverProxy, como IoCreateDriverProxyExtension ou IoRegisterDriverProxyEndpoints.

A função pode ser chamada em qualquer nível de IRQL e é segura de usar durante a inicialização do driver.

Requirements

Consulte também

DRIVER_PROXY_FEATURE_FLAGS

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints

DRIVER_OBJECT