2.5 WD_PcmciaScanCards()

PURPOSE

$\bullet$Detects PCMCIA devices attached to PCMCIA sockets, which conform to the input criteria (manufacturer ID and/or card ID), and returns the number and location (bus, socket and function) of the detected devices.

PROTOTYPE

DWORD WD_PcmciaScanCards(
    HANDLE hWD,
    WD_PCMCIA_SCAN_CARDS *pPcmciaScan);

PARAMETERS

Name	Type	Input/Output
$\bullet$hWD	HANDLE	Input
$\bullet$pPcmciaScan	WD_PCMCIA_SCAN_CARDS*
$\gg$searchId	WD_PCMCIA_ID
$\diamond$wManufacturerId	WORD	Input
$\diamond$wCardId	WORD	Input
$\gg$dwCards	DWORD	Output
$\gg$cardId	WD_PCMCIA_ID[WD_PCMCIA_CARDS]
$\diamond$wManufacturerId	DWORD	Output
$\diamond$wCardId	DWORD	Output
$\gg$cardSlot	WD_PCMCIA_SLOT[WD_PCMCIA_CARDS]
$\diamond$uBus	BYTE	Output
$\diamond$uSocket	BYTE	Output
$\diamond$uFunction	BYTE	Output
$\diamond$uPadding	BYTE	N/A
$\gg$dwOptions	DWORD	Input

DESCRIPTION

Name	Description
hWD	The handle to WinDriver's kernel-mode driver received from WD_Open() [5.2]
pPcmciaScan	Pointer to a PCMCIA bus scan information structure:
searchId	PCMCIA card ID information structure:
searchId.wManufacturerId	The manufacturer ID of the PCMCIA cards to detect. If 0, the function will search for all PCMCIA manufacturer IDs.
searchId.wCardId	The card ID of the PCMCIA cards to detect. If 0, the function will search for all PCMCIA card IDs. If both wManufacturerId and wCardId are set to 0 the function will return information regarding all connected PCMCIA cards.
dwCards	Number of cards detected for the specified search criteria set in the searchId field
cardId	Array of PCMCIA card ID information structures for the detected PCMCIA cards that match the search criteria set in the searchId field:
cardId.wManufacturerId	Manufacturer ID
cardId.wCardId	Card ID
cardSlot	Array of PCMCIA slot information structures for the detected PCMCIA cards that match the search criteria set in the searchId field:
cardSlot.uBus	Bus number (0 based)
cardSlot.uSocket	Socket number (0 based)
cardSlot.uFunction	Function number (0 based)
dwOptions	Should always be set to 0 (reserved for future use)

RETURN VALUE

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise [A].

EXAMPLE

WD_PCMCIA_SCAN_CARDS pcmciaScan;
DWORD cards_found;
WD_PCMCIA_SLOT pcmciaSlot;

BZERO(pcmciaScan);
pcmciaScan.searchId.wManufacturerId = 0x1234;
pcmciaScan.searchId.wCardId = 0x5678;
WD_PcmciaScanCards(hWD, &pcmciaScan);
if (pcmciaScan.dwCards>0) /* Found at least one device */
{
    /* Use the first card found */
    pcmciaSlot = pcmciaScan.cardSlot[0];
}
else
{
    printf("No matching PCMCIA devices found\n");
}