Método IPortClsVersion::GetVersion (portcls.h)
O método GetVersion retorna a versão do sistema operacional Windows no qual o driver está em execução.
Sintaxe
DWORD GetVersion();
Valor de retorno
O método GetVersion retorna um valor DWORD que especifica o número de versão do Windows. Para obter mais informações, consulte a seção Comentários a seguir.
Observações
O método GetVersion retorna informações de versão que especificam a versão do Windows.
Os possíveis números de versão do Windows que GetVersion podem retornar são mostrados na tabela a seguir.
| Número de versão | Versão do Windows | Suporta |
|---|---|---|
| kVersionWin98 | Windows 98 | Não |
| kVersionWin98SE | Windows 98 Second Edition | Não |
| kVersionWin2K | Windows 2000 | Não |
| kVersionWin98SE_QFE2 | Pacote do Windows 98 SE + Hot-Fix 269601.) | Não |
| kVersionWin2K_SP2 | Windows 2000 + Service Pack 2 | SIM |
| kVersionWinME | Windows Me | Não |
| kVersionWin98SE_QFE3 | Reservado para uso futuro | SIM |
| kVersionWinME_QFE1 | Reservado para uso futuro | SIM |
| kVersionWinXP | Windows XP | SIM |
| kVersionWinXPSP1 | Windows XP + Service Pack 1 | SIM |
| kVersionWinServer2003 | Windows Server 2003 | SIM |
| kVersionWin2K_UAAQFE | Pacote do Windows 2000 + hot-fix com suporte IUnregister_Xxx_ (Consulte Subdevices de Áudio Dinâmico.) | SIM |
| kVersionWinXP_UAAQFE | Pacote do Windows XP + hot-fix com suporte IUnregister_Xxx_ (consulte Subdevices de áudio dinâmico.) | SIM |
| kVersionWinServer2003_UAAQFE | Pacote do Windows Server 2003 + hot-fix com suporte IUnregister_Xxx_ (Consulte Subdevices de Áudio Dinâmico.) | SIM |
Os números de versão na tabela anterior são definidos em portcls.h do arquivo de cabeçalho. Observe que portcls.h define números de versão para versões do Windows que dão suporte e não dão suporte à interface IPortClsVersion. Ambos os tipos de número de versão podem ser úteis. Um driver de miniporto normalmente contém uma rotina proprietária que determina a versão do Windows e pode retornar qualquer um dos números de versão na tabela anterior. Quando executada em uma plataforma que não dá suporte a IPortClsVersion, essa rotina precisa usar outros testes de software para determinar a versão do Windows. Esses testes normalmente dependem da função IoIsWdmVersionAvailable. Para obter um exemplo de código de tal rotina, consulte o driver de áudio de exemplo sb16 no WDK (Windows Driver Kit).
Os números de versão na tabela anterior são listados em ordem aproximadamente cronológica. Cada versão sucessiva do Windows na tabela não representa necessariamente um superconjunto de recursos da versão anterior. Por exemplo, a versão representada por kVersionWin2K tem mais recursos de áudio do que a versão representada por kVersionWin98SE_QFE2.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | portcls.h (inclua Portcls.h) |
| IRQL | PASSIVE_LEVEL |