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 track number of the tape.
Parameters
- hDevice
[in] Handle to the target object. To obtain a device handle, call the CreateFile function with a name dynamically obtained from the SetupDiEnumDeviceInterfaces function. - dwIoControlCode
[in] Set to IOCTL_VVCR_SET_MECHANISM_TRACK_NUMBER. 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_SetMechanismTrackNumber_Request structure. The vvsmtn_TrackNumber member must be pre-initialized. - BufferSize
[in] Set to sizeof(VVCR_SetMechanismTrackNumber_Request). - lpOutBuffer
[in] Unused. Set to NULL. - nOutBufferSize
[in] Unused. 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, and the track number associated with this. This cache is updated by the application by IOCTL_VVCR_SET_MECHANISM_TRACK_NUMBER. 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_SetMechanismTrackNumber_Request
Send Feedback on this topic to the authors