IOCTL_VVCR_EVENT (Windows CE 5.0)
This IOCTL permits the caller to receive notifications from the virtual VCR driver about events that have occurred.
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] Target operation and the type of device on which to perform it. Set to IOCTL_VVCR_EVENT. - lpInBuffer
[in] Initialized VVCR_Event_Request structure. The vve_Flags member must be pre-initialized. - BufferSize
[in] Size of the VVCR_Event_Request structure. Set to sizeof(VVCR_Event_Request). - lpOutBuffer
[out] Pointer to a VVCR_Event_Response structure. - nOutBufferSize
[out] This field should be pre-initialized with the maximum size of the lpOutBuffer parameter, which should be sizeof(VVCR_Event_Response). - 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, NULL. Otherwise, this should point to a completely filled out OVERLAPPED structure that contains a valid event. The event is 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
This command is for notifications from the virtual VCR driver to the application. The response structure is created with a set of response structures containing arguments, one for each VVCR_EVENT type defined.
This command is to be issued to the virtual VCR driver, and the driver completes it when the driver has information to return. For many of the return possibilities, the driver is responsible for taking action and notifying the virtual VCR driver of the result of the action by calling IOCTL_VVCR_COMPLETE. If the application does not complete its request in time, the virtual VCR driver will automatically send a REJECT message back to the original sender.
The VVCR_EVENT_Type enumeration represents AV/C requests that have been sent to the virtual VCR driver and that require action by the application for completion. VVCR_EVENT_PlugStateChange does not require action by the application.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Avc_vvcr.h.
See Also
CreateFile | DeviceIoControl | IOCTL_VVCR_COMPLETE | VVCR_Event_Request | VVCR_Event_Response | VVCR_EVENT_Type
Send Feedback on this topic to the authors