GetDeviceConfigurationData (Windows Embedded CE 6.0)

1/6/2010

This function retrieves configuration data, starting at the offset, about a slot or address on an I/O bus.

Syntax

ULONG GetDeviceConfigurationData (
  HANDLE hBusAccess,
  DWORD dwSpace,
  DWORD BusNumber,
  DWORD SlotNumber,
  DWORD dwOffset,
  DWORD dwLength,
  PVOID pBuffer
);

Parameters

• hBusAccess
  [in] Handle obtained from CreateBusAccessHandle.

• dwSpace
  [in] Configuration address space from which to get information. The following list shows the address spaces you can specify:

  • For a PCI bus, you can use PCI_WHICHSPACE_CONFIG or PCI_WHICHSPACE_ROM.
  • For a 32-bit PC Card, you can use PCCARD_PCI_CONFIGURATION_SPACE.
  • For a 16-bit PC Card, you can use PCCARD_ATTRIBUTE_MEMORY, PCCARD_COMMON_MEMORY, PCCARD_ATTRIBUTE_MEMORY_INDIRECT, or PCCARD_COMMON_MEMORY_INDIRECT.

  These are defined in %_WINCEROOT%\Public\Common\DDK\Inc\Cebuscfg.h.

• BusNumber
  [in] Zero-based and system-assigned bus number for the device, used with InterfaceType to identify the bus for systems with more than one bus of the same type.

• SlotNumber
  [in] Logical slot number or location of the device. This value is the slot and function numbers combined.

• dwOffset
  [in] Byte offset in the PCI_COMMON_CONFIG structure for which the requested information should be returned. Callers can use the system-defined constant PCI_COMMON_HDR_LENGTH to specify the device-specific area of PCI_COMMON_CONFIG.

• dwLength
  [in] Maximum number of bytes in pBuffer.

• pBuffer
  [out] Pointer to a buffer to receive configuration information.

Return Value

Returns the number of bytes of data it received in the specified buffer.

Requirements

See Also

Reference

CEDDK Dynamic-Link Library Bus Access Functions
CreateBusAccessHandle
HalGetBusDataByOffset
PCI_COMMON_CONFIG