
Description of the DP Functions, Data, and Error Codes
DP Base Programming Interface for CP 5613/CP 5614
74
C79000-G8976-C108-01
Syntax
DPR_DWORD DP_get_pointer (
DPR_DWORD user_handle, // in
DPR_DWORD timeout, // in
DPR_CP5613_DP_T volatile **dpr, // out
DP_ERROR_T *error); // out
Parameters
Name Description
user_handle User handle assigned with the DP_open call.
timeout
Duration of the maximum wait time (in milliseconds) until
the function returns.
Limit values:
0: No wait time
(Function returns
immediately)
0x7FFFFFFE: Maximum wait time
DP_TIMEOUT_FOREVER: "Endless" wait time
dpr Address of a pointer provided by the user program. If
successful, the address for access to the process image of
the CP 5613/CP 5614 is entered here - using this pointer,
the DP user program can then access the data image of
the CP 5613/CP 5614 directly.
error
Address of a structure provided by the user program of the
type DP_ERROR_T - If an error occurred, the structure
contains details for troubleshooting (see Section 4.4).
Return Value
Name Description
DP_OK Successful completion of the function
otherwise if error->error_code ==
DP_RET_TIMEOUT
Timeout – Pointer being used by another
program.
other Unsuccessful completion of the function
Kommentare zu diesen Handbüchern