DDKReg_GetPciInfo (Windows CE 5.0)

Send Feedback

This function populates the DDKPCIINFO structure with information from the registry.

DWORD WINAPI DDKReg_GetPciInfo(HKEY hk, PDDKPCIINFO ppi);

Parameters

  • hk
    [in] Handle to a registry key.

  • ppi
    [out] Pointer to a DDKPCIINFO structure.

    The following table shows the registry values that this function retrieves.

    Registry value retrieved Registry type DDKPCIINFO member Default value if the registry value is not present
    DeviceNumber

    PCI device number.

    REG_DWORD dwDeviceNumber This function returns ERROR_INVALID_DATA.
    FunctionNumber

    PCI function number. Indicates a single function device on a multifunction PCI card.

    REG_DWORD dwFunctionNumber This function returns ERROR_INVALID_DATA.
    InstanceIndex REG_DWORD dwInstanceIndex This function returns ERROR_INVALID_DATA.
    Bitmask of PCIID_XXX values.

    This bitmask indicates which identifier values are present in the idVals array.

    This value is not in the registry. dwWhichIds Not applicable. This value is not in the registry.
    Class

    Subclass

    ProgIF

    VendorId

    DeviceId

    RevisionId

    SubVendorId

    SubSystemId

    These device identifiers populate an array. Consult the dwWhichIds bitmask to determine which ones are present in this structure.

    REG_DWORD

    REG_DWORD

    REG_DWORD

    REG_DWORD

    REG_DWORD

    REG_DWORD

    REG_DWORD

    REG_DWORD

    idVals If a value is not present in the registry, its corresponding bit is not set in dwWhichIds.

Return Values

The following table shows the return values for this function.

Value Description
ERROR_SUCCESS Indicates that the DDKPCIINFO structure has been populated successfully.
ERROR_INVALID_PARAMETER Indicates a problem with the populated DDKPCIINFO structure.
ERROR_INVALID_DATA Indicates that a registry value had an unexpected type or was internally inconsistent.
Any other return value Indicates a return code defined in Winerror.h.

Remarks

The dwWhichIds member of DDKPCIINFO is a bitmask that indicates which PCI bus identifier fields are included in the target device's PCI header. Not all fields are included.

Requirements

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

See Also

DDKPCIINFO | Interrupts | Loading Device Drivers | PCI Bus Driver

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.