ILTDicRd Interface

Interface Properties:

Type Name Description
VARIANT_BOOL IsCompressedStream A read-only property that indicates whether the stream is compressed. A value of VARIANT_TRUE indicates that the stream is either MPEG-2, MPEG-4, H.264, or MPEG-TS. Otherwise, the value is VARIANT_FALSE.
LONG_PTR get_DicomDSPtr Retrieves the currently initialized DICOM dataset. Typecast this pointer to LDicomDS before using it. Do not make changes to the dataset after the filter is connected, since this might cause problems with the LEAD DICOM Reader. Use this property, instead of get_DicomDS, to obtain the dataset. It is compatible with both 32 and 64 bit platforms.

This is the interface for the LEAD DICOM Reader.

Interface Methods:

HRESULT SetDicomDSPtr(LONG_PTR newVal, int bCopy);

Parameters

newVal Pointer to the user dataset.
bCopy A value that specifies whether the filter should make a copy of the passed dataset for future usage. Possible values are:
Value Meaning
TRUE Make a copy of the dataset (allocating memory for it, and maintaining responsibility for freeing this memory).
FALSE The user will take care of the pointer life (and ensure its availability for the Writer as long as it is needed).

Description

Sets the DICOM dataset inside the LEAD DICOM Reader filter. This function should be used instead of SetDicomDS for compatibility on both 32 bit and 64 bit platforms. Before using this function you need to first create and initialize a dataset using the raster toolkit and LDicomDS::InitDS and either LDicomDS::LoadDS or LDicomDS::LoadDSMemory. Use this method, instead of SetDicomDS, to assign the dataset. It is compatible with both 32 and 64 bit platforms. This function fails if:

Call this method with pDS set to NULL:

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT put_InputFileName(const OLECHAR *pszFileName)

Parameters

pzFileName

Pointer to an OLECHAR string that contains the input DICOM file

Description

Sets the input file name. Should you set the InputFileName to NULL, be sure to set an input dataset using SetDicomDS because otherwise you will have no input data and the filter will fail to connect. The function fails under the following conditions:

The default value is ". Note that the DICOM file may contain MPEG2 or H.264/AVCdata, which would require that a MPEG-2 video decoder be installed before the file could be played.

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT get_InputFileName(OLECHAR **ppszFileName)

Parameters

ppszFileName

Address of a pointer to the returned DICOM input file name.

Description

Retrieves the input file name. This function allocates memory for the string. You are responsible for freeing the memory by using SysFreeString().

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT get_ConnectionState(int * pbConnected)

Parameters

pbConnected Pointer to a variable that will receive the connection state of the output pin. Possible values are:
  Value Meaning
  TRUE The output pin is connected.
  FALSE The output pin is not connected.

Description

Gets a value that indicates whether the output pin is connected.

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT get_DicomDS(long * pDS)

Parameters

pDS

Address of a pointer to the returned dataset.

Description

Retrieves the currently initialized DICOM dataset. Typecast this pointer to LDicomDS before using it. Do not make changes to the dataset after the filter is connected, since this might cause problems with the LEAD DICOM Reader. This function is only compatible with 32 bit platforms. Use get_DicomDSPtr instead.

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT put_FrameTime(long lFrameTime)

Parameters

lFrameTime

New frame time value in milliseconds.

Description

Sets the frame time (the time each frame is displayed while playing the PixelData), in milliseconds. Possible values range between 20 and 1000. The Frame Control feature must be enabled in order to control the frame time (and thus the play speed). If frame time is not enabled, the stream plays with the frame time set to 40 milliseconds (25 frames per second).

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT get_FrameTime(long * lFrameTime)

Parameters

lFrameTime

Pointer to a variable that will receive the current frame time.

Description

Retrieves the frame time (the time each frame is displayed while playing the PixelData), in milliseconds. The default value is 40.

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT put_FrameControl(int  bEnableFrameControl)

Parameters

bEnableFrameControl A Boolean value that enables or disables frame control. Possible values are:
  Value Meaning
  TRUE Enable frame control.
  FALSE Disable frame control.

Description

Sets the frame control using put_FrameTime or set through the interface by using the property page.

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT get_FrameControl(int *bEnableFrameControl)

Parameters

bEnableFrameControl Pointer to a variable that indicates whether frame control is enabled. Possible values are:
  Value Meaning
  TRUE Frame control is enabled.
  FALSE Frame control is disabled.

Description

Retrieves a value that indicates whether frame control is enabled. The default values is FALSE.

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT put_FrameDropping(int EnableFrameDropping)

Parameters

bEnableFrameDropping A Boolean variable that contains a value that indicates whether frames can be dropped. Possible values are:
  Value Meaning
  TRUE Frames can be dropped.
  FALSE Keep every frame.

Description

Use this function to set the filter to drop frames when necessary in order to maintain the frame rate. To enable frame dropping set bEnableFrameDropping to TRUE. To keep every frame set bEnableFrameDropping to FALSE.

Returns

Always returns S_OK.

HRESULT get_FrameDropping(int  *pbEnableFrameDropping)

Parameters

pbEnableFrameDropping pointer to a Boolean value that indicates whether the frame dropping feature is currently set to drop frames.
  Value Meaning
  TRUE The filter is currently set to drop frames when necessary to maintain the frame time.
  FALSE The filter is set to keep every frame.

Description

Gets a value that indicates whether the filter is currently set to drop frames when necessary to maintain the frame time. The default value is FALSE.

Returns

S_OK

SUCCESS

E_INVALIDARG

The input pointer is invalid.

HRESULT SetDicomDS(long newVal, int bCopy)

Parameters

newVal Pointer to the user dataset.
bCopy A value that specifies whether the filter should make a copy of the passed dataset for future usage. Possible values are:
Value Meaning
TRUE Make a copy of the dataset (allocating memory for it, and maintaining responsibility for freeing this memory).
FALSE The user will take care of the pointer life (and ensure its availability for the Writer as long as it is needed).

Description

Sets the DICOM dataset inside the LEAD DICOM Reader filter. Before using this function you need to first create and initialize a dataset using the raster toolkit and LDicomDS::InitDS and either LDicomDS::LoadDS or LDicomDS::LoadDSMemory. This function is only compatible with 32 bit platforms. Use SetDicomDSPtr instead. This function fails if:

Call this method with pDS set to NULL:

Returns

S_OK

SUCCESS

< 0

An error occurred.

HRESULT ResetToDefaults()

Description

Resets the LEAD DICOM Reader option values to the default values, as follows:

Returns

Always returns S_OK.

This filter is included as part of the following modules:

LEADTOOLS Medical Multimedia Module

Help Version 20.0.2020.3.31
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Filters C API Help