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)