Función WdfDriverIsVersionAvailable (wdfdriver.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El método WdfDriverIsVersionAvailable devuelve un valor booleano que indica si el controlador se ejecuta con una versión especificada de la biblioteca de Kernel-Mode Driver Framework.

Sintaxis

BOOLEAN WdfDriverIsVersionAvailable(
  [in] WDFDRIVER                            Driver,
  [in] PWDF_DRIVER_VERSION_AVAILABLE_PARAMS VersionAvailableParams
);

Parámetros

[in] Driver

Identificador del objeto de controlador del marco de trabajo del controlador que obtuvo el controlador de una llamada anterior a WdfDriverCreate o WdfGetDriver.

[in] VersionAvailableParams

Puntero a una estructura de WDF_DRIVER_VERSION_AVAILABLE_PARAMS que identifica una versión de la biblioteca de marcos.

Valor devuelto

WdfDriverIsVersionAvailable devuelve TRUE si el controlador se ejecuta con la versión de la biblioteca que especifica el parámetro VersionAvailableParams .

El método devuelve FALSE si el controlador no se está ejecutando con la versión de biblioteca especificada o si la estructura de WDF_DRIVER_VERSION_AVAILABLE_PARAMS no es válida.

Se produce una comprobación de errores del sistema si el controlador no es válido.

Comentarios

Para obtener más información sobre las versiones de la biblioteca, consulte Control de versiones de la biblioteca de marcos.

Ejemplos

En el ejemplo de código siguiente se notifica un error si detecta un número de versión de biblioteca inesperado.

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

WDF_DRIVER_VERSION_AVAILABLE_PARAMS_INIT(&ver, 1, 0);
if (!WdfDriverIsVersionAvailable(
                                 driver,
                                 &ver
                                 )) {
    DbgPrint("Unexpected library version.\n");
}

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfdriver.h (incluir Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverCreate

WdfDriverRetrieveVersionString

WdfGetDriver