Condividi tramite


Funzione WdfDriverIsVersionAvailable (wdfdriver.h)

[Si applica a KMDF e UMDF]

Il metodo WdfDriverIsVersionAvailable restituisce un valore booleano che indica se il driver è in esecuzione con una versione specificata della libreria Kernel-Mode Driver Framework.

Sintassi

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

Parametri

[in] Driver

Handle per l'oggetto driver del framework del driver ottenuto dal driver da una chiamata precedente a WdfDriverCreare o WdfGetDriver.

[in] VersionAvailableParams

Puntatore a una struttura WDF_DRIVER_VERSION_AVAILABLE_PARAMS che identifica una versione della libreria framework.

Valore restituito

WdfDriverIsVersionAvailable restituisce TRUE se il driver è in esecuzione con la versione della libreria specificata dal parametro VersionAvailableParams.

Il metodo restituisce false se il driver non è in esecuzione con la versione della libreria specificata o se la struttura WDF_DRIVER_VERSION_AVAILABLE_PARAMS non è valida.

Se l'handle driver di non è valido, si verifica un controllo dei bug di sistema.

Osservazioni:

Per altre informazioni sulle versioni della libreria, vedere Framework Library Versioning.

Esempi

L'esempio di codice seguente segnala un errore se rileva un numero di versione della libreria imprevisto.

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

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

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
versione minima di KMDF 1.0
versione minima di UMDF 2.0
intestazione wdfdriver.h (include Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverCreare

WdfDriverRetrieveVersionString

WdfGetDriver