FSH BUFSTATE: Difference between revisions

Latest revision as of 15:59, 20 February 2020

Legacy Function Warning
It is recommended to use a newer replacement for this function.
Replacement:
Remarks:	REMOVED in OS/2 Version 2.0

FSH_BUFSTATE is used retrieve or set the state of a buffer.

Syntax

FSH_BUFSTATE (pBuf, flag, pState)

Parameters

pBuf: pointer to buffer. This pointer was returned to the FSD by FSH_GETBUFFER

flag

indicates get or set buf state.

flag == 0 indicates retrieve state
flag == 1 indicates set state

pState: for set, points to new state of buffer on input. For retrieve, points to state of buffer.; State == 0x00000080 indicates dirty buffer.; All other values are reserved.

Returns

Error code if error detected, 0 otherwise.

ERROR_INVALID_PARAMETER - pointer to buffer is invalid or reserved state bits are set.

Calling Sequence

int pascal FSH_BUFSTATE (pBuf, flag, pState)

char *          pBuf;
unsigned long   flag;
unsigned long * pState;

Remarks

Note: To set the opposite of a defined state, call FSH_BUFSTATE with the bit not set. For example, to set a buffer not dirty, pass 0x00000000 as the new state.

Reminder: OS/2 does not validate input parameters, so FSD should call FSH_PROBEBUF where appropriate.

@@ Line 3: / Line 3: @@
 |Remarks=REMOVED in OS/2 Version 2.0
 }}
+FSH_BUFSTATE is used retrieve or set the state of a buffer.
-Get or set buffer state FSH_SEMREQUEST. Request a semaphore.
-FSH_BUFSTATE - Get or set buffer state:
-* To help avoid deadlocks, [[FSH_ADDSHARE]] should not be called while * owning an OS/2 buffer.
-* FSH_BUFSTATE is used retrieve or set the state of a buffer.
 ==Syntax==
   FSH_BUFSTATE (pBuf, flag, pState)
 ==Parameters==
-; pBuf: pointer to buffer. This pointer was returned to the FSD.
+; pBuf : pointer to buffer. This pointer was returned to the FSD by FSH_GETBUFFER
-; flag: indicates get or set buf state.
+; flag : indicates get or set buf state.
 :*flag == 0 indicates retrieve state
 :*flag == 1 indicates set state
-;pState: for set, points to new state of buffer on input. For * retrieve, points to state of buffer.
-:* State == 0xû080 indicates dirty buffer.
-* All other values are reserved.
+;pState : for set, points to new state of buffer on input. For retrieve, points to state of buffer.
+:State == 0x00000080 indicates dirty buffer.
+:All other values are reserved.
 ==Returns==
-: Error code if error detected
+Error code if error detected, 0 otherwise.
-: 0 otherwise.
+ERROR_INVALID_PARAMETER - pointer to buffer is invalid or reserved state bits are set.
-* ERROR INVALID_PARAMETER - pointer to buffer is invalid or * reserved state bits are set.
 ==Calling Sequence==
 <PRE>
-int far pascal FSH_BUFSTATE (pBuf, flag, pState)
+int pascal FSH_BUFSTATE (pBuf, flag, pState)
-char far * pBuf;
+char *          pBuf;
-unsigned short flag;
+unsigned long   flag;
-unsigned short far * pState;
+unsigned long * pState;
 </PRE>
 ==Remarks==
-* Reminder: OS/2 does not validate input parameters, so FSD should * call [[FSH_PROBEBUF]] where appropriate.
+;Note : To set the opposite of a defined state, call FSH_BUFSTATE with the bit not set. For example, to set a buffer not dirty, pass 0x00000000 as the new state.
+;Reminder: OS/2 does not validate input parameters, so FSD should call FSH_PROBEBUF where appropriate.
 [[Category:IFS Interfaces]]
 {{DISPLAYTITLE:FSH_BUFSTATE}}