SVR5 and SCO OpenServer 5
RequestWindow(D3pccard)
RequestWindow --
allocate a block of system memory or I/O address space
Synopsis
#include <sys/types.h>
#include <sys/lcs.h>
#include <sys/lss.h>
int CardServices (RequestWindow, ClientHandle_t **pClientHandle,
int n1, int RelReqWindowLen,
RelReqWindow_t *pRelReqWindow, rm_key_t key);
Description
RequestWindow( )
requests CardServices to allocate
a block of system memory or I/O address space.
Arguments
pClientHandle-
Pointer to a
ClientHandle(D4pccard)
structure.
n1-
NULL
RelReqWindowLen-
Length of the
RelReqWindow(D4pccard)
structure.
Must be set to 13.
pRelReqWindow-
Pointer to a
RelReqWindow(D4pccard)
structure.
key-
Resource manager
key.
Return values
BAD_ARG_LENGTH-
RelReqWindowLen not equal to 13.
BAD_ATTRIBUTE-
Bit map in the
usAttributes
member
of the RelReqWindow structure is invalid.
BAD_BASE-
System memory address not valid.
BAD_HANDLE-
*pClientHandle does not point to registered owner.
BAD_SIZE-
Window size not valid.
BAD_SOCKET-
Socket not valid.
BAD_SPEED-
Requested speed not supported.
NO_CARD-
No card inserted.
OUT_OF_RESOURCE-
CardServices resource configuration table full.
SUCCESS-
Window bound to client.
Usage
RequestWindow( )
is called as part of client initialization and configuration.
Bit 0 of the usAttributes
member of the
RelReqWindow(D4pccard)
structure is set to determine
whether the allocated memory
is for I/O address space
or memory window address space.
The determination between memory and I/O address space
is made in the C struct RelReqWindow_t : usAttributes : bit 0.
If the bit is set to 1,
I/O address space is being requested.
Otherwise the request is for memory window address space.
The client can not actually use the resources until the
RequestConfiguration(D3pccard)
service returns successfully.
ReleaseWindow(D3pccard)
undoes RequestWindow.
Context and synchronization
Blockable, initialization, or user
context
Hardware applicability
All
Version applicability
pccard:
1, 2, 3
References
ClientHandle(D4pccard),
ReleaseWindow(D3pccard),
RelReqWindow(D4pccard),
RequestConfiguration(D3pccard)
config(D2pccard),
init(D2pccard),
_load(D2pccard)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005