DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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