IOCTL_VVCR_SET_MECHANISM_TRACK_NUMBER (Windows CE 5.0)
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