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
| Requisito | Valor |
|---|---|
| da 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 de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Consulte também
WDF_DRIVER_VERSION_AVAILABLE_PARAMS