Share via

DDKReg_GetPciInfo (Windows Embedded CE 6.0)

  • Article

1/6/2010

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

Syntax

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 Value

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

Header ddkreg.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

DDKPCIINFO

Concepts

Registry Helper Functions
Interrupts
Loading Device Drivers

Other Resources

PCI Bus Driver