Função WdfDriverIsVersionAvailable (wdfdriver.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfDriverIsVersionAvailable retorna um valor booliano que indica se o driver está em execução com uma versão especificada da biblioteca do Kernel-Mode Driver Framework.

Sintaxe

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

Parâmetros

[in] Driver

Um identificador para o objeto de driver de estrutura do driver que o driver obteve de uma chamada anterior para WdfDriverCreate ou WdfGetDriver.

[in] VersionAvailableParams

Um ponteiro para uma estrutura WDF_DRIVER_VERSION_AVAILABLE_PARAMS que identifica uma versão da biblioteca de estruturas.

Retornar valor

WdfDriverIsVersionAvailable retornará TRUE se o driver estiver em execução com a versão da biblioteca especificada pelo parâmetro VersionAvailableParams .

O método retornará FALSE se o driver não estiver em execução com a versão de biblioteca especificada ou se a estrutura WDF_DRIVER_VERSION_AVAILABLE_PARAMS for inválida.

Um bug do sistema marcar ocorrerá se o identificador do Driver for inválido.

Comentários

Para obter mais informações sobre versões de biblioteca, consulte Controle de versão da biblioteca de estrutura.

Exemplos

O exemplo de código a seguir relatará um erro se detectar um número de versão 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 Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdriver.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverCreate

WdfDriverRetrieveVersionString

WdfGetDriver