Compartilhar via

DDKReg_GetIsrInfo (Compact 2013)

  • Artigo

3/26/2014

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).

Syntax

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 Value

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

Header

ddkreg.h

Library

coredll.lib

See Also

Reference

Registry Helper Functions
DDKISRINFO