Metodo IPortClsVersion::GetVersion (portcls.h)
Il metodo GetVersion restituisce la versione del sistema operativo Windows in cui è in esecuzione il driver.
Sintassi
DWORD GetVersion();
Valore restituito
Il metodo GetVersion restituisce un valore DWORD che specifica il numero di versione di Windows. Per altre informazioni, vedere la sezione Osservazioni seguente.
Osservazioni
Il metodo GetVersion restituisce informazioni sulla versione che specifica la versione di Windows.
I possibili numeri di versione di Windows che GetVersion possono restituire sono illustrati nella tabella seguente.
| Numero di versione | Versione di Windows | Supporta |
|---|---|---|
| kVersionWin98 | Windows 98 | No |
| kVersionWin98SE | Windows 98 Second Edition | No |
| kVersionWin2K | Windows 2000 | No |
| kVersionWin98SE_QFE2 | Windows 98 SE + Hot-Fix Package 269601. | No |
| kVersionWin2K_SP2 | Windows 2000 + Service Pack 2 | SÌ |
| kVersionWinME | Windows Me | No |
| kVersionWin98SE_QFE3 | Riservato per uso futuro | SÌ |
| kVersionWinME_QFE1 | Riservato per uso futuro | SÌ |
| kVersionWinXP | Windows XP | SÌ |
| kVersionWinXPSP1 | Windows XP + Service Pack 1 | SÌ |
| kVersionWinServer2003 | Windows Server 2003 | SÌ |
| kVersionWin2K_UAAQFE | Windows 2000 + pacchetto di correzione rapida con supporto IUnregister_Xxx_ (vedi sottodispositivi audio dinamici.) | SÌ |
| kVersionWinXP_UAAQFE | Pacchetto Windows XP + hot fix con supporto di IUnregister_Xxx_ (vedere sottodispositivi audio dinamici.) | SÌ |
| kVersionWinServer2003_UAAQFE | Windows Server 2003 + hot fix package with IUnregister_Xxx_ support (vedere Dynamic Audio Subdevices.) | SÌ |
I numeri di versione nella tabella precedente sono definiti nel file di intestazione portcls.h. Si noti che portcls.h definisce i numeri di versione per le versioni di Windows che e non supportano l'interfaccia IPortClsVersion. Entrambi i tipi di numero di versione possono essere utili. Un driver miniport contiene in genere una routine proprietaria che determina la versione di Windows e può restituire uno dei numeri di versione nella tabella precedente. Quando viene eseguito in una piattaforma che non supporta IPortClsVersion, questa routine deve usare altri test software per determinare la versione di Windows. Questi test si basano in genere sulla funzione IoIsWdmVersionAvailable. Per un esempio di codice di tale routine, vedi il driver audio di esempio sb16 in Windows Driver Kit (WDK).
I numeri di versione nella tabella precedente sono elencati in ordine cronologico approssimativo. Ogni versione successiva di Windows nella tabella non rappresenta necessariamente un superset di funzionalità della versione precedente. Ad esempio, la versione rappresentata da kVersionWin2K dispone di più funzionalità audio rispetto alla versione rappresentata da kVersionWin98SE_QFE2.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | portcls.h (include Portcls.h) |
| IRQL | PASSIVE_LEVEL |