SVR5 and SCO OpenServer 5
ReleaseDMA(D3pccard)
ReleaseDMA --
release DMA channel
Synopsis
#include <sys/types.h>
#include <sys/lcs.h>
#include <sys/lss.h>
int CardServices (ReleaseDMA, ClientHandle_t *pClientHandle,
int n1, int RelReqDMALen,
RelReqDMA_t *pRelReqDMA, rm_key_t key);
Description
ReleaseDMA( )
requests CardServices to access a card's configuration data
and release a DMA channel it had assigned to a card.
Arguments
pClientHandle-
Pointer to a
ClientHandle(D4pccard)
structure.
n1-
NULL
RelReqDMALen-
Length of the
RelReqDMA(D4pccard)
structure.
Must be set to 6.
pRelReqDMA-
Pointer to a
RelReqDMA(D4pccard)
structure.
key-
Resource manager
key.
Return values
BAD_ARG_LENGTH-
RelReqDMALen not equal to 6.
BAD_ARGS-
usDesiredChannle in the
RelReqDMA_t structure does not match
ucAssignedChannel received from the
RequestDMA(D3pccard)
service.
BAD_HANDLE-
Client handle not valid.
BAD_SOCKET-
Socket invalid.
CONFIGURATION_LOCKED-
Configuration not released
SUCCESS-
Configuration and DMA channel released.
Usage
ReleaseDMA( )
is called as part of client removal
to release a DMA channel that was allocated with the
RequestDMA(D3pccard)
request that is now being cancelled.
The logical socket, desired channel, attributes,
and assigned channel pointed to by *pRelReqDMA
must match those that had been returned by the previous call to
RequestDMA(D3pccard).
Context and synchronization
Interrupt, initialization, or user
context
Hardware applicability
16-bit PC Card only.
Version applicability
pccard:
1, 2, 3
References
ClientHandle(D4pccard),
RelReqDMA(D4pccard),
RequestDMA(D3pccard)
config(D2pccard),
halt(D2pccard),
_unload(D2pccard)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005