Browse Source

Added PXENV_GET_FILE_SIZE.

Documented non-blocking nature of PXENV_FILE_READ.

Changed FileName field in PXENV_FILE_OPEN to be a SEGOFF16, to avoid a
fixed 256-byte length limit on URLs.
tags/v0.9.3
Michael Brown 17 years ago
parent
commit
bfc335faa8
1 changed files with 43 additions and 1 deletions
  1. 43
    1
      src/doc/pxe_extensions

+ 43
- 1
src/doc/pxe_extensions View File

@@ -17,8 +17,8 @@ Description:	Opens a file specified by a URL for reading.  Multiple
17 17
 typedef struct s_PXENV_FILE_OPEN {
18 18
 	PXENV_STATUS Status;
19 19
 	UINT16 FileHandle;
20
+	SEGOFF16 FileName;
20 21
 	UINT32 Reserved;
21
-	UINT8 FileName[256];
22 22
 } t_PXENV_FILE_OPEN;
23 23
 
24 24
 
@@ -122,6 +122,12 @@ Output:		PXENV_EXIT_SUCCESS or PXENV_EXIT_FAILURE must be
122 122
 		structure must be set to one of the values represented
123 123
 		by the PXENV_STATUS_xxx constants.
124 124
 
125
+		This API function is non-blocking.  PXENV_EXIT_SUCCESS
126
+		and PXENV_STATUS_SUCCESS is returned if a data block
127
+		has been transferred into the caller's buffer.
128
+		PXENV_EXIT_FAILURE and PXENV_STATUS_FAILURE is
129
+		returned if no data is available to transfer.
130
+
125 131
 Description:	Read from a previously opened file.
126 132
 
127 133
 
@@ -149,3 +155,39 @@ BufferSize:	Number of bytes written to the data buffer.  End of
149 155
 		file if this is zero.
150 156
 
151 157
 Status:		See PXENV_STATUS_xxx constants.
158
+
159
+
160
+
161
+
162
+GET FILE SIZE
163
+
164
+Op-Code:	PXENV_GET_FILE_SIZE (00e4h)
165
+
166
+Input:		Far pointer to a t_PXENV_GET_FILE_SIZE parameter
167
+		structure that has been initialised by the caller.
168
+
169
+Output:		PXENV_EXIT_SUCCESS or PXENV_EXIT_FAILURE must be
170
+		returned in AX.  The status field in the parameter
171
+		structure must be set to one of the values represented
172
+		by the PXENV_STATUS_xxx constants.
173
+
174
+Description:	Determine size of a previously opened file.
175
+
176
+
177
+typedef struct s_PXENV_GET_FILE_SIZE {
178
+	PXENV_STATUS Status;
179
+	UINT16 FileHandle;
180
+	UINT32 FileSize;
181
+} t_PXENV_GET_FILE_SIZE;
182
+
183
+
184
+Set before calling API service:
185
+
186
+FileHandle:	Handle obtained when file was opened.
187
+
188
+
189
+Returned from API service:
190
+
191
+FileSize:	Size of the file in bytes.
192
+
193
+Status:		See PXENV_STATUS_xxx constants.

Loading…
Cancel
Save