XXX_Seek (Device Manager) (Windows CE 5.0)
This function moves the data pointer in the device.
DWORDXXX_Seek(DWORDhOpenContext,long Amount,WORDType);
Parameters
- hOpenContext
[in] Handle to the open context of the device. The XXX_Open (Device Manager) function creates and returns this identifier. - Amount
[in] Number of bytes to move the data pointer in the device. A positive value moves the data pointer toward the end of the file and a negative value moves it toward the beginning. - Type
[in] Starting point for the data pointer. The following table shows the available values for this parameter.Value Description FILE_BEGIN Indicates that the starting point is zero or the beginning of the file. FILE_CURRENT Indicates that the current value of the file pointer is the starting point. FILE_END Indicates that the current end-of-file position is the starting point.
Return Values
The new data pointer for the device indicates success. A value of –1 indicates failure.
Remarks
After an application calls the SetFilePointer function to move the data pointer in the device, the operating system invokes this function. If your device is capable of opening more than once, this function modifies only the data pointer for the instance specified by hOpenContext.
Device Manager uses the XXX prefix as a placeholder. When implementing the stream interface, replace XXX with a prefix appropriate for your implementation or use undecorated entry point names in conjunction with DEVFLAGS_NAKEDENTRIES. For more information about other valid Flags values, see ActivateDeviceEx.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Developer implemented.
Link Library: Developer implemented.
See Also
Device File Names | ActivateDeviceEx | SetFilePointer | XXX_Open (Device Manager)
Send Feedback on this topic to the authors