IBM Books

Image, Audio, and Video Extenders Administration and Programming

DBvOpenHandle


Image Audio Video
    X

Allocates space for a DBvIOType structure and opens the video handle for pixel access. The structure points to the first frame number (frame 0). The video can be a BLOB. The video is copied to the temporary file in a directory specified by the DB2VIDEOTEMP environment variable. The isIdx flag is set based on the existence of the random access index.

Authorization

Select

Library file
OS/2 and Windows AIX, HP-UX, and Solaris
dmbshot.lib libdmbshot.a (AIX)

libdmbshot.sl (HP-UX)

libdmbshot.so (Solaris)

Include file

dmbshot.h

Syntax

long DBvOpenHandle(
      DBvIOType **video,
      DB2Video *videoHandle
      SQLHDBC hdbc
      );

Parameters

video (out)
The pointer to the video structure.

videoHandle (in)
The video handle.

hdbc (in)
The database handle from SQLConnect.

Error codes

MMDB_SUCCESS
API call processed successfully.

MMDB_RC_CANNOT_OPEN
Cannot open video file.

MMDB_RC_NO_MEMORY
Not enough memory.

MMDB_RC_NO_INDEX
No video random access index.

MMDB_RC_NOT_CONNECTED
Application does not have valid connection to a database.

MMDB_RC_INVALID_HANDLE
The video handle is not valid.

Examples

Open the videoHandle using the videoa pointer:

#include <dmbshot.h>
 
rc = DBvOpenHandle(&oa, videoHandle, hdbc);


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]