Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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