Método IPortClsVersion::GetVersion (portcls.h)
O GetVersion método retorna a versão do sistema operacional Windows em que o driver está sendo executado.
Sintaxe
DWORD GetVersion();
Retornar valor
O GetVersion método 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.
Comentários
O GetVersion método 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 da 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 | YES |
| kVersionWinME | Windows Me | não |
| kVersionWin98SE_QFE3 | Reservado para uso futuro | YES |
| kVersionWinME_QFE1 | Reservado para uso futuro | YES |
| kVersionWinXP | Windows XP | YES |
| kVersionWinXPSP1 | Windows XP + Service Pack 1 | YES |
| kVersionWinServer2003 | Windows Server 2003 | YES |
| kVersionWin2K_UAAQFE | Pacote do Windows 2000 + hot-fix com suporte IUnregister_Xxx_ (consulte Subdevices de áudio dinâmico.) | YES |
| kVersionWinXP_UAAQFE | Pacote do Windows XP + hot-fix com suporte IUnregister_Xxx_ (consulte Subdispositivos de áudio dinâmico.) | YES |
| kVersionWinServer2003_UAAQFE | Windows Server 2003 + pacote de hot-fix com suporte a IUnregister_Xxx_ (consulte Subdispositivos de áudio dinâmico.) | YES |
Os números de versão na tabela anterior são definidos no arquivo de cabeçalho portcls.h. Observe que portcls.h define números de versão para versões do Windows que dão e não dão suporte à interface IPortClsVersion . Ambos os tipos de número de versão podem ser úteis. Um driver de miniporta 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 dessa rotina, consulte o driver de áudio de exemplo sb16 no WDK (Kit de Driver do Windows).
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 pelo kVersionWin2K tem mais recursos de áudio do que a versão representada por kVersionWin98SE_QFE2.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | portcls.h (inclua Portcls.h) |
| IRQL | PASSIVE_LEVEL |