IOCTL_VVCR_SET_MECHANISM_POSITION (Windows CE 5.0)
This IOCTL permits the caller to notify the virtual VCR driver of the current position of the tape.
Parameters
- hDevice
[in] Handle to the target object. To get a device handle, call the CreateFile function with a name obtained dynamically from the SetupDiEnumDeviceInterfaces function. - dwIoControlCode
[in] Set to IOCTL_VVCR_SET_MECHANISM_POSITION. This value identifies the target operation and the type of device on which to perform the operation. - lpInBuffer
[in] Must be completed with a properly initialized VVCR_SetMechanismPosition_Request structure. The vvsmp_Hour, vvsmp_Minute, vvsmp_Second, vvsmp_Frame, and rtc_Negative members must be pre-initialized. - BufferSize
[in] Set to sizeof(VVCR_SetMechanismPosition_Request). - lpOutBuffer
[in] Unused. Should be set to NULL. - nOutBufferSize
[in] Unused. Should be set to 0. - lpBytesReturned
[out] Pointer to a DWORD that receives the actual count of bytes returned by the function in the output buffer. - lpOverlapped
[out] If not used, set to NULL. Otherwise, this should point to a completely filled out OVERLAPPED structure that contains a valid event. The event will be signaled when the I/O operation is complete.
Return Values
If the operation succeeds, the DeviceIoControl function returns a non-zero value. If the operation fails, DeviceIoControl returns zero. To obtain extended error information, call the GetLastError function.
Remarks
The virtual VCR driver keeps a cache of the last known position of the tape. This cache is update by the application by IOCTL_VVCR_SET_MECHANISM_POSITION. When remote devices request the current position, the result is read from the cache of the virtual VCR driver.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Avc_vvcr.h.
See Also
CreateFile | DeviceIoControl | IOCTL_VVCR_SET_MECHANISM_STATE | VVCR_SetMechanismPosition_Request
Send Feedback on this topic to the authors