Função WdfDriverIsVersionAvailable (wdfdriver.h)

[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 da estrutura do driver que o driver obteve de uma chamada anterior para wdfDriverCreate ou WdfGetDriver.

[in] VersionAvailableParams

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

Valor de retorno

WdfDriverIsVersionAvailable retornará verdadeiro 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 da biblioteca especificada ou se a estrutura WDF_DRIVER_VERSION_AVAILABLE_PARAMS for inválida.

Uma verificação de bugs do sistema ocorre se o identificador de do Driver for inválido.

Observações

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

Exemplos

O exemplo de código a seguir relatará um erro se detectar um número de versão inesperado da biblioteca.

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

Consulte também

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverCreate

WdfDriverRetrieveVersionString

do WdfGetDriver