fixing cap_pvpapi interface and making sure both AVT Manta and Proscilla

series are supported. Testing this with both cams for Windows and Linux
exhaustively.

Optimizing memory footprint by removing unused calls.

Adapted with the input of Shai

Added small example that illustrates how it should work.

samples/cpp/videocapture_pvapi.cpp

@@ -0,0 +1,36 @@
+//////////////////////////////////////////////////////
+// Sample illustrating the use of the VideoCapture  //
+// interface in combination with PvAPI interface    //
+//                                                  //
+// Succesfully tested on Prosilica and Manta series //
+//////////////////////////////////////////////////////
+
+#include <iostream>
+#include "opencv2/opencv.hpp"
+
+using namespace std;
+using namespace cv;
+
+int main()
+{
+    // Capturing multiple AVT cameras can be done by simply initiating
+    // two VideoCaptures after eachother.
+    VideoCapture camera1(0 + CV_CAP_PVAPI);
+    VideoCapture camera2(0 + CV_CAP_PVAPI);
+    Mat frame1, frame2;
+
+    for(;;){
+        camera1 >> frame1;
+        camera2 >> frame2;
+
+        imshow("camera 1 frame", frame1);
+        imshow("camera 2 frame", frame2);
+
+        int key = waitKey(10);
+        if(key == 27){
+            break;
+        }
+    }
+
+    return 0;
+}