WdfDriverIsVersionAvailable function (wdfdriver.h)

Artikel
02/22/2024

[Applies to KMDF and UMDF]

The WdfDriverIsVersionAvailable method returns a Boolean value that indicates whether the driver is running with a specified version of the Kernel-Mode Driver Framework library.

Syntax

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

Parameters

[in] Driver

A handle to the driver's framework driver object that the driver obtained from a previous call to WdfDriverCreate or WdfGetDriver.

[in] VersionAvailableParams

A pointer to a WDF_DRIVER_VERSION_AVAILABLE_PARAMS structure that identifies a version of the framework library.

Return value

WdfDriverIsVersionAvailable returns TRUE if the driver is running with the version of the library that the VersionAvailableParams parameter specifies.

The method returns FALSE if the driver is not running with the specified library version or if the WDF_DRIVER_VERSION_AVAILABLE_PARAMS structure is invalid.

A system bug check occurs if the Driver handle is invalid.

Remarks

For more information about library versions, see Framework Library Versioning.

Examples

The following code example reports an error if it detects an unexpected library version number.

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

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

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.0
Minimum UMDF version	2.0
Header	wdfdriver.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
DDI compliance rules	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Delen via