Función IoGetDriverProxyFeatures (wdm.h)

La función IoGetDriverProxyFeatures obtiene las marcas de características DriverProxy para el sistema actual y el controlador especificado.

Esta función permite a los controladores determinar si la funcionalidad DriverProxy está disponible y habilitada para su instancia de controlador específica. DriverProxy permite la funcionalidad del controlador intercambiable en caliente, ya que permite a los controladores registrar funciones de punto de conexión que se pueden reemplazar en tiempo de ejecución sin descargar el controlador.

Syntax

VOID IoGetDriverProxyFeatures(
  PDRIVER_OBJECT              DriverObject,
  PDRIVER_PROXY_FEATURE_FLAGS Flags
);

Parámetros

DriverObject

[in, opcional] Puntero opcional al DRIVER_OBJECT para comprobar la compatibilidad con DriverProxy. Si este parámetro es NULL, la función comprueba si DriverProxy está habilitado para todos los controladores del sistema.

Flags

[out] Puntero a una estructura de DRIVER_PROXY_FEATURE_FLAGS que recibe las marcas de características DriverProxy. La estructura indica si la funcionalidad DriverProxy está disponible y habilitada.

Valor devuelto

Esta función no devuelve un valor.

Observaciones

La función IoGetDriverProxyFeatures determina la disponibilidad de DriverProxy en función de varios factores:

• Si el sistema admite la funcionalidad DriverProxy
• Si el kernel seguro se está ejecutando (necesario para DriverProxy)
• Si el controlador específico se excluye de las operaciones DriverProxy mediante la configuración del Registro
• Si DriverProxy se ha deshabilitado globalmente

Los controladores deben llamar a esta función antes de intentar usar otras API de DriverProxy, como IoCreateDriverProxyExtension o IoRegisterDriverProxyEndpoints.

Se puede llamar a la función en cualquier nivel IRQL y es seguro usar durante la inicialización del controlador.

Requisitos

Consulte también

DRIVER_PROXY_FEATURE_FLAGS

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints

DRIVER_OBJECT