IOCTL_VVCR_COMPLETE (Windows CE 5.0)
This IOCTL permits the caller to complete asynchronous requests previously returned to the caller from IOCTL_VVCR_EVENT.
Parameters
- hDevice
[in] Handle to the target object. To obtain a device handle, call the CreateFile function with a name obtained dynamically from the SetupDiEnumDeviceInterfaces function. - dwIoControlCode
[in] Set to IOCTL_VVCR_COMPLETE. 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_Complete_Request structure. The vvcr_RequestIdentifier and vvcr_Status members must be pre-initialized. - BufferSize
[in] Set to sizeof(VVCR_Complete_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 GetLastError.
Remarks
The virtual VCR notifies the application of outstanding commands that it has received over the serial bus from a remote client by completing pending IOCTL_VVCR_EVENT requests. Those requests contain the definitions of the request in question, along with a handle that uniquely represents that request to the virtual VCR driver. When the application has completed the request, it can utilize IOCTL_VVCR_COMPLETE to notify the virtual VCR driver. When this executes, the virtual VCR driver can issue a completion to the original remote requestor.
If the application receives a request through IOCTL_VVCR_EVENT and either does not later complete it with IOCTL_VVCR_COMPLETE or not does complete it within a reasonable amount of time, the virtual VCR device might time out the request and return a failed response to the original remote requester.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Avc_vvcr.h.
See Also
CreateFile | DeviceIoControl | IOCTL_VVCR_EVENT | VVCR_Complete_Request
Send Feedback on this topic to the authors