Share via

DDKReg_GetIsrInfo (Windows CE 5.0)

  • Article

Send Feedback

This function populates a DDKISRINFO structure with information from the registry. If you specify an interrupt service routine (ISR) DLL, you must also specify a handler entry point and an interrupt request (IRQ).

DWORD WINAPI DDKReg_GetIsrInfo(HKEY hk, PDDKISRINFO pii);

Parameters

  • hk
    [in] Handle to a registry key.

  • pii
    [out] Pointer to a DDKISRINFO structure.

    The following table shows the registry values this function retrieves.

    Registry value Registry type Data structure member Default value if the registry value is not present
    Irq REG_DWORD dwIrq IRQ_UNSPECIFIED
    Sysintr REG_DWORD dwSysintr SYSINTR_NOP
    IsrDll REG_SZ szIsrDll DDKReg_GetIsrInfo returns ERROR_INVALID_DATA.
    IsrHandler REG_SZ szIsrHandler DDKReg_GetIsrInfo returns ERROR_INVALID_DATA.

Return Values

The following table shows the return values for this function.

Value Description
ERROR_SUCCESS Indicates that the DDKISRINFO structure was populated successfully.
ERROR_INVALID_PARAMETER Indicates a problem with the populated DDKISRINFO structure.
ERROR_INVALID_DATA Indicates that a registry value has an unexpected type, or that device window address and length lists do not have the same length.

For example, when the operating system (OS) has configured the IsrHandler and the IsrDll values in the registry, but the Irq value has not been configured, the function fails and returns ERROR_INVALID_DATA.
Any other return value Indicates a return code defined in Winerror.h.

Remarks

When the DDKReg_GetIsrInfo function reads the registry, it does the following:

  1. If an IsrDll entry is configured, it ensures that there is an IsrHandler entry configured.
  2. If there is no IsrDll entry nor an IsrHandler entry, the function returns ERROR_SUCCESS.
  3. If there is an IsrHandler entry, but no IsrDll entry, the function returns ERROR_INVALID_DATA.
  4. If there are both IsrDll and IsrHandler entries, the function checks that there must be a valid Irq entry configured.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Ddkreg.h.
Link Library: Coredll.lib.

See Also

Interrupts | Loading Device Drivers | PCI Bus Driver | DDKISRINFO

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.