Partilhar via


DRIVER_PROXY_FEATURE_FLAGS união (wdm.h)

A estrutura DRIVER_PROXY_FEATURE_FLAGS contém sinalizadores de recursos que indicam a disponibilidade e o status da funcionalidade DriverProxy para o sistema e o driver atuais.

Sintaxe

typedef union _DRIVER_PROXY_FEATURE_FLAGS {
  ULONG  AsUlong;
  struct {
    ULONG Enabled : 1;
    ULONG Reserved : 31;
  };
} DRIVER_PROXY_FEATURE_FLAGS, *PDRIVER_PROXY_FEATURE_FLAGS;

Members

AsUlong

O conjunto completo de sinalizadores de recursos como um único valor ULONG . Isso fornece acesso a todos os sinalizadores como um inteiro de 32 bits para facilitar a inicialização, a comparação ou o armazenamento.

Enabled

Um sinalizador de bit único que indica se a funcionalidade DriverProxy está habilitada e disponível. Quando esse bit é definido como 1, APIs driverProxy como IoCreateDriverProxyExtension e IoRegisterDriverProxyEndpoints podem ser usadas com êxito . Quando esse bit é 0, a funcionalidade DriverProxy não está disponível.

Reserved

Bits reservados para uso futuro. Atualmente, esses bits não são usados e devem ser ignorados pelos drivers. Eles são reservados para uma possível expansão futura de sinalizadores de recursos DriverProxy.

Observações

Essa estrutura é usada pelo IoGetDriverProxyFeatures para retornar informações sobre se a funcionalidade de hot-swappable do DriverProxy é compatível e habilitada. Os drivers devem chamar essa função para recuperar a estrutura e verificar o sinalizador habilitado antes de tentar usar APIs DriverProxy.

O sinalizador Habilitado é definido com base em várias condições do sistema, incluindo:

  • O Kernel Seguro deve estar em execução
  • O sistema deve ser configurado para operações do DriverProxy
  • O driver não deve ser excluído da funcionalidade DriverProxy por meio de configurações do Registro
  • DriverProxy não deve estar desabilitado globalmente

Os drivers devem inicializar essa estrutura como zero antes de passá-la para IoGetDriverProxyFeatures para garantir que quaisquer bits não inicializados não contenham valores aleatórios.

Requirements

Requirement Value
Header wdm.h

Consulte também

IoGetDriverProxyFeatures

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints