Funzione WdfDriverIsVersionAvailable (wdfdriver.h)

Articolo
02/27/2024

[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 di Driver Framework di Kernel-Mode.

Sintassi

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

Parametri

[in] Driver

Handle all'oggetto driver del framework del driver ottenuto da una chiamata precedente a WdfDriverCreate 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.

Un controllo del bug di sistema si verifica se l'handle driver non è valido.

Commenti

Per altre informazioni sulle versioni della libreria, vedere Controllo delle versioni della libreria Framework.

Esempio

Nell'esempio di codice seguente viene segnalato 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 KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfdriver.h (includere Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverCreate

WdfDriverRetrieveVersionString

WdfGetDriver

Condividi tramite