Sony Trinitron WEGA KV-DZ29M91, Service Manual, Page: 159 / 170

XYGATE
®
Data Protection
™
Reference Manual
Appendix E: XDP API Procedures
XYPRO Technology Corporation
139
Proprietary and Confidential
E9: __XYPRO_ENCR_SEND_TO_ENCR_SRV
short __XYPRO_ENCR_SEND_TO_ENCR_SRV ( long _far *encr_ctx /* input */
, short serv_index /* input */
, char _far *op /* input */
,[long long _far *process_time] /* output */
, short n_encr_key_len /* input */
, char _far *encr_key /* input */
, short _far *nencr_error /* output */
, char _far *pbuffer /* input */
,[long io_tag] /* input */
, short _far *nscsend_op_num /* output */
);
Initiates a NOWAIT Pathway send to the encryption server. This operation is NOWAITed and so should
be completed by a call to the AWAITIOX procedure.
Instead of processing each encryption item sequentially, this function can be used to trigger simultaneous
encryption/decryption of data items which could reduce total run time. If WAITed i/o is desired, use the
__XYPRO_ENCR_ENCRYPT()
or
__XYPRO_ENCR_DECRYPT()
functions instead.
Parameters
Returns 0 when successful. Refer to the list of error codes in the XDP manual for a description of the
error code values.
encr_ctx
A pointer to the previously allocated context area (refer to
__XYPRO_ENCR_MEMBLK_SIZE ()
on page 129 ).
serv_index
An index value returned from the
__XYPRO_ENCR_ADD_ENCR_DATA ()
procedure. If there is only one
encryption provider defined, then any of the values returned from
__XYPRO_ENCR_ADD_ENCR_DATA ()
can be
used.
process_time
The microseconds needed by the encryption server to encrypt the data. This parameter is an optional
parameter and is only returned by this procedure if a waited send operation is performed; if a nowait send
operation is done, it is returned from
__XYPRO_ENCR_IO_COMPLETED ()
. Waited or nowait operation is
indicated by the presence or absence of the io_tag parameter.
op
A string containing the operation to be performed. Valid values are OP_ENCRYPT or OP_DECRYPT .
These values are defined in XDPDECTH.
nencr_key_len
The length of the key contained in
sencr_key
.
sencr_key
This is NOT an actual encryption key; it is a value that is passed to the encryption provider to reference
the actual database key. For the VOLTAGE encryption provider, it is a string in the format
"YYYYMMDDHHMNSSZ". This is a date time string that is expressed in UTC as indicated by the trailing
“Z”. Changing this value is one way to roll the encryption key, but all data previously encrypted using a
different date time value then cannot be decrypted unless the original date time value used to encrypt it