Método IPortClsVersion::GetVersion (portcls.h)
El GetVersion método devuelve la versión del sistema operativo Windows en la que se ejecuta el controlador.
Sintaxis
DWORD GetVersion();
Valor devuelto
El GetVersion método devuelve un valor DWORD que especifica el número de versión de Windows. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
Comentarios
El GetVersion método devuelve información de versión que especifica la versión de Windows.
Los posibles números de versión de Windows que GetVersion pueden devolver se muestran en la tabla siguiente.
| Número de versión | Versión de Windows | Es compatible con |
|---|---|---|
| kVersionWin98 | Windows 98 | no |
| kVersionWin98SE | Windows 98 Second Edition | no |
| kVersionWin2K | Windows 2000 | no |
| kVersionWin98SE_QFE2 | Paquete windows 98 SE + Hot-Fix 269601). | no |
| kVersionWin2K_SP2 | Windows 2000 y Service Pack 2 | SÍ |
| kVersionWinME | Windows Me | no |
| kVersionWin98SE_QFE3 | Reservado para uso futuro | SÍ |
| kVersionWinME_QFE1 | Reservado para uso futuro | SÍ |
| kVersionWinXP | Windows XP | SÍ |
| kVersionWinXPSP1 | Windows XP + Service Pack 1 | SÍ |
| kVersionWinServer2003 | Windows Server 2003 | SÍ |
| kVersionWin2K_UAAQFE | Windows 2000 + paquete de corrección activa con IUnregister_Xxx_ compatibilidad (consulta Subdevices de audio dinámico). | SÍ |
| kVersionWinXP_UAAQFE | Windows XP + paquete de corrección activa con IUnregister_Xxx_ compatibilidad (consulta Subdevices de audio dinámico). | SÍ |
| kVersionWinServer2003_UAAQFE | Windows Server 2003 + paquete de corrección activa con IUnregister_Xxx_ compatibilidad (consulta Subdevices de audio dinámico). | SÍ |
Los números de versión de la tabla anterior se definen en el archivo de encabezado portcls.h. Tenga en cuenta que portcls.h define los números de versión para las versiones de Windows que sí y no admiten la interfaz IPortClsVersion . Ambos tipos de número de versión pueden ser útiles. Un controlador de minipuerto normalmente contiene una rutina propietaria que determina la versión de Windows y puede devolver cualquiera de los números de versión de la tabla anterior. Cuando se ejecuta en una plataforma que no admite IPortClsVersion, esta rutina debe usar otras pruebas de software para determinar la versión de Windows. Estas pruebas suelen basarse en la función IoIsWdmVersionAvailable . Para obtener un ejemplo de código de este tipo de rutina, consulta el controlador de audio de ejemplo sb16 en el Kit de controladores de Windows (WDK).
Los números de versión de la tabla anterior se enumeran en orden cronológico aproximadamente. Cada versión sucesiva de Windows de la tabla no representa necesariamente un superconjunto de características de la versión anterior. Por ejemplo, la versión representada por kVersionWin2K tiene más características de audio que la versión representada por kVersionWin98SE_QFE2.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | portcls.h (incluir Portcls.h) |
| IRQL | PASSIVE_LEVEL |