CeQueryInstructionSet (RAPI) (Windows Embedded CE 6.0)

1/6/2010

The CeQueryInstructionSet function queries a remote Windows Embedded CE-based device to determine whether it supports the specified processor-specific instruction set.

Syntax

BOOL CeQueryInstructionSet(
  DWORD dwInstructionSet,
  LPDWORD lpdwCurrentInstructionSet
);

Parameters

  • dwInstructionSet
    [in] The instruction set that will be queried to determine if it is supported by the currently running OS. Setting this parameter to PROCESSOR_QUERY_INSTRUCTION causes the device's current instruction set to be returned in the lpdwCurrentInstructionSet parameter. The following table shows the accepted values for this parameter.

    Value Description Floating point hardware Floating point emulation

    PROCESSOR_X86_32BIT_INSTRUCTION

    32bit x86.

    Yes

    Yes

    PROCESSOR_MIPS_MIPS16_INSTRUCTION

    MIPS16 instruction set.

    No

    Yes

    PROCESSOR_MIPS_MIPSII_INSTRUCTION

    MIPS II instruction set.

    No

    Yes

    PROCESSOR_MIPS_MIPSIIFP_INSTRUCTION

    MIPS II instruction set.

    Yes

    No

    PROCESSOR_MIPS_MIPSIV_INSTRUCTION

    MIPS IV instruction set.

    No

    Yes

    PROCESSOR_MIPS_MIPSIVFP_INSTRUCTION

    MIPS IV instruction set.

    Yes

    No

    PROCESSOR_HITACHI_SH3_INSTRUCTION

    Hitachi SH3 instruction set.

    No

    Yes

    PROCESSOR_HITACHI_SH3DSP_INSTRUCTION

    Hitachi SH3 instruction set with built-in digital signal processor (DSP).

    No

    No

    PROCESSOR_HITACHI_SH4_INSTRUCTION

    Hitachi SH4 instruction set.

    Yes

    No

    PROCESSOR_ARM_V4_INSTRUCTION

    ARM V4 instruction set.

    No

    Yes

    PROCESSOR_ARM_V4FP_INSTRUCTION

    ARM V4 instruction set.

    Yes

    No

    PROCESSOR_ARM_V4I_INSTRUCTION

    ARM V4 with Thumb instruction set.

    No

    Yes

    PROCESSOR_ARM_V4IFP_INSTRUCTION

    ARM V4 with Thumb instruction set.

    Yes

    No

    PROCESSOR_ARM_V4T_INSTRUCTION

    ARM V4 with Thumb instruction set.

    No

    Yes

    PROCESSOR_ARM_V4TFP_INSTRUCTION

    ARM V4 with Thumb instruction set.

    Yes

    No

    PROCESSOR_QUERY_INSTRUCTION

    Request to have the current instruction set reported to the caller.

    No

    No

  • lpdwCurrentInstructionSet
    [out] Returns the current instruction set supported by the OS.

Return Value

Returns nonzero if the instruction set passed in through dwInstructionSet is supported by the current OS. Otherwise, returns zero.

Returns nonzero if dwInstructionSet is set to PROCESSOR_QUERY_INSTRUCTION. The lpdwCurrentInstructionSet parameter is then set to the current instruction set supported.

Returns zero if the dwInstructionSet value is unknown.

Remarks

This function can be used by any application that needs to determine if the code about to install or run will work on the current OS. The OS knows explicitly what instruction it will execute, and therefore will inform you if your installation should continue.

The following table shows the instruction set compatibility.**

OS instructions set Supported instruction sets

PROCESSOR_X86_32BIT_INSTRUCTION

PROCESSOR_X86_32BIT_INSTRUCTION

PROCESSOR_MIPS_MIPS16_INSTRUCTION

PROCESSOR_MIPS_MIPS16_INSTRUCTION PROCESSOR_MIPS_MIPSII_INSTRUCTION

PROCESSOR_MIPS_MIPSII_INSTRUCTION

PROCESSOR_MIPS_MIPSII_INSTRUCTION

PROCESSOR_MIPS_MIPSIIFP_INSTRUCTION

PROCESSOR_MIPS_MIPSIIFP_INSTRUCTION

PROCESSOR_MIPS_MIPSIV_INSTRUCTION

PROCESSOR_MIPS_MIPSIV_INSTRUCTION

PROCESSOR_MIPS_MIPSIVFP_INSTRUCTION

PROCESSOR_MIPS_MIPSIVFP_INSTRUCTION

PROCESSOR_HITACHI_SH3_INSTRUCTION

PROCESSOR_HITACHI_SH3_INSTRUCTION

PROCESSOR_HITACHI_SH3DSP_INSTRUCTION

PROCESSOR_HITACHI_SH3DSP_INSTRUCTION PROCESSOR_HITACHI_SH3_INSTRUCTION

PROCESSOR_HITACHI_SH4_INSTRUCTION

PROCESSOR_HITACHI_SH4_INSTRUCTION

PROCESSOR_ARM_V4_INSTRUCTION

PROCESSOR_ARM_V4_INSTRUCTION

PROCESSOR_ARM_V4FP_INSTRUCTION

PROCESSOR_ARM_V4FP_INSTRUCTION

PROCESSOR_ARM_V4_INSTRUCTION

PROCESSOR_ARM_V4I_INSTRUCTION

PROCESSOR_ARM_V4I_INSTRUCTION

PROCESSOR_ARM_V4T_INSTRUCTION

PROCESSOR_ARM_V4IFP_INSTRUCTION

PROCESSOR_ARM_V4IFP_INSTRUCTION

PROCESSOR_ARM_V4TFP_INSTRUCTION

PROCESSOR_ARM_V4I_INSTRUCTION

PROCESSOR_ARM_V4T_INSTRUCTION

PROCESSOR_ARM_V4T_INSTRUCTION

PROCESSOR_ ARM_V4I_INSTRUCTION

PROCESSOR_ARM_V4T_INSTRUCTION

PROCESSOR_ARM_V4TFP_INSTRUCTION

PROCESSOR_ARM_V4TFP_INSTRUCTION

PROCESSOR_ARM_V4IFP_INSTRUCTION

PROCESSOR_ARM_V4I_INSTRUCTION

PROCESSOR_ARM_V4T_INSTRUCTION

Requirements

Header rapi.h
Library rapi.lib
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

RAPI Functions