Metodo IPortClsVersion::GetVersion (portcls.h)
Il GetVersion metodo restituisce la versione del sistema operativo Windows in cui è in esecuzione il driver.
Sintassi
DWORD GetVersion();
Valore restituito
Il GetVersion metodo restituisce un valore DWORD che specifica il numero di versione di Windows. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Commenti
Il GetVersion metodo 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 | Supporti |
|---|---|---|
| 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 | YES |
| kVersionWinME | Windows Me | no |
| kVersionWin98SE_QFE3 | Riservate per utilizzo futuro | YES |
| kVersionWinME_QFE1 | Riservate per utilizzo futuro | YES |
| kVersionWinXP | Windows XP | YES |
| kVersionWinXPSP1 | Windows XP + Service Pack 1 | YES |
| kVersionWinServer2003 | Windows Server 2003 | YES |
| kVersionWin2K_UAAQFE | Windows 2000 + hot-fix package with IUnregister_Xxx_ support (Vedi Dynamic Audio Subdevices).) | YES |
| kVersionWinXP_UAAQFE | Windows XP + hot-fix package with IUnregister_Xxx_ support (vedi Dynamic Audio Subdevices).) | YES |
| kVersionWinServer2003_UAAQFE | Windows Server 2003 + hot-fix package with IUnregister_Xxx_ support (vedere Dynamic Audio Subdevices.) | YES |
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 sia per le versioni di Windows che e che 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 qualsiasi dei numeri di versione nella tabella precedente. Quando viene eseguita 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 una routine di questo tipo, vedere 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 ha più funzionalità audio rispetto alla versione rappresentata da kVersionWin98SE_QFE2.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | portcls.h (include Portcls.h) |
| IRQL | PASSIVE_LEVEL |