DDKReg_GetIsrInfo (Windows CE 5.0)
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:
- If an IsrDll entry is configured, it ensures that there is an IsrHandler entry configured.
- If there is no IsrDll entry nor an IsrHandler entry, the function returns ERROR_SUCCESS.
- If there is an IsrHandler entry, but no IsrDll entry, the function returns ERROR_INVALID_DATA.
- 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