 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function allocates a window within system memory used to access PC Card memory or I/O space. The window must be mapped by the CardMapWindowfunction before the window can access the PC Card.
CARD_WINDOW_HANDLE CardRequestWindow( CARD_CLIENT_HANDLE hCardClient PCARD_WINDOW_PARMS pCardWinParms );
Parameters
- hCardClient
- Client handle obtained from the CardRegisterClientfunction.
- pCardWinParms
- Pointer to a
CARD_WINDOW_PARMSstructure.
Return Values
A driver handle indicates success. NULL indicates failure, and GetLastErrorreturns one of the following values:
- CERR_BAD_ARGS
- Indicates that the pointer specified for pCardWinParmsis invalid.
- CERR_BAD_HANDLE
- Indicates that hCardClientis not a valid client.
- CERR_BAD_SOCKET
- Indicates that the socket identifier specified for the hSocketmember for CARD_WINDOW_PARMSis invalid or that no PC Card is inserted.
- CERR_OUT_OF_RESOURCE
- Indicates that Card Services is unable to allocate memory to
track the memory window or that the system has no windows available
that match the requested window attributes.
Remarks
This function allocates a memory or an I/O window, according to the values specified in CARD_WINDOW_PARMS. You can use the returned handle for subsequent calls to the CardMapWindowand CardModifyWindowfunctions.
Driver name
PCMCIA
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
CardMapWindow, CardModifyWindow, CardReleaseWindow
Last updated on Tuesday, July 13, 2004