L_DicomGetInfoCS

#include "ltdic.h"

L_VOID EXT_FUNCTION L_DicomGetInfoCS(hDS, pnCommand, pbRequest)

HDICOMDS hDS;

/* a DICOM handle */

L_UINT16 * pnCommand;

/* pointer to a variable */

L_BOOL * pbRequest;

/* pointer to a variable */

Retrieves information about the specified Command Set.

Parameter

Description

hDS

A DICOM handle.

pnCommand

Pointer to a variable to be updated with the command associated with the Command Set. Possible values are:

 

Value

Meaning

 

COMMAND_C_STORE

[0x0001] Composite Store Command

 

COMMAND_C_FIND

[0x0020] Composite Find Command

 

COMMAND_C_GET

[0x0010] Composite Get Command

 

COMMAND_C_MOVE

[0x0021] Composite Move Command

 

COMMAND_C_CANCEL

[0x0FFF] Composite Cancel Command

 

COMMAND_C_ECHO

[0x0030] Composite Echo Command

 

COMMAND_N_REPORT

[0x0100] Normalized Report Command

 

COMMAND_N_GET

[0x0110] Normalized Get Command

 

COMMAND_N_SET

[0x0120] Normalized Set Command

 

COMMAND_N_ACTION

[0x0130] Normalized Action Command

 

COMMAND_N_CREATE

[0x0140] Normalized Create Command

 

COMMAND_N_DELETE

[0x0150] Normalized Delete Command

 

pbRequest

Pointer to a variable to be updated with a value that indicates whether the command set is a request or a response. Possible values are:

 

Value

Meaning

 

TRUE

The command set is a request.

 

FALSE

The command set is a response.

Returns

None.

Comments

A Command Set is a special type of Data Set. Therefore, to create a Command Set you must first create a Data Set using L_DicomCreateDS and then initialize it by calling L_DicomInitS.

You can also determine the type of a command set by "and-ing" the value of the TAG_COMMAND_FIELD with COMMAND_REQUEST[0x0000] or COMMAND_RESPONSE[0x8000].

In addition, you can determine whether a command set has a required data set by "and-ing" the value of the TAG_DATA_SET_TYPE element with COMMAND_DATASET_PRESENT, COMMAND_DATASET_IDENTIFIER, or COMMAND_DATASET_ABSENT.

Required DLLs and Libraries

LTDIC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_DicomInitCS, L_DicomCreateDS

Topics:

Working with Command Sets

Example

For an example, refer to L_DicomInitCS.