GpibSetNotifySignal


Function

Sets arbitrary signal, and sends message to application immediately when the set signal changed.

Format

Ret = GpibSetNotifySignal (  Id, hWnd, NotifySignalMask )

Parameter

Id [ VB.NET: Short ][ C, C++: short ][ C#: short ]

Specifies DevID or EqpID.

Whichever it specifies, operation does not change.

 

hWnd [ VB.NET: Integer ][ C, C++: HANDLE ][ C#: uint ]

Sets window handler. Sets CMessage.ocx handle in case of VB.

 

NotifySignalMask [ VB.NET: Integer ][ C, C++: unsigned long ][ C#: uint ]

Sets the value of signal mask. The event occurs even if only one signal changed when multi-signal has been set.

Sets it to 0 to cancel the event.

Master (System Controller) :

Mask Bit Position

Hex Value

Explanation

6 to 31

--

Reserved

5

20

Detection of SRQ receiving

0 to 4

--

Reserved

Slave (Non-controller) :

Mask Bit Position

Hex Value

Explanation

10 to 31

--

Reserved

9

200

Detection of IFC receiving

8

100

Detection of Serial Poll ending after sending SRQ

7

80

Detection of local lockout change

6

40

Detection of remote/local change

5

--

Reserved

4

10

Detection of device trigger receiving

3

8

Detection of device clear receiving

2

4

Detection of data receiving

1

2

Detection of specifying Listener

0

1

Detection of specifying Talker

Event Parameter

wParam [ VB.NET: Integer ][ C, C++: unsigned long ][ C#: uint ]

Retrieves bits being signal enabled.

Master (System Controller) :

Mask Bit Position

Hex Value

Explanation

6 to 31

--

Reserved

5

20

Detection of SRQ receiving

0 to 4

--

Reserved

Slave (Non-controller) :

Mask Bit Position

Hex Value

Explanation

10 to 31

--

Reserved

9

200

Detection of IFC receiving

8

100

Detection of serial poll ending after sending SRQ

7

80

Detection of local lockout change

6

40

Detection of remote/local change

5

--

Reserved

4

10

Detection of device trigger receiving

3

8

Detection of device clear receiving

2

4

Detection of data receiving

1

2

Detection of specifying listener

0

1

Detection of specifying talker

(It is normal if the bit not being set by NotifySignalMask is enabled. Please confirm only the pertinent bit when you want to confirm enabled status.)

lParam [ VB.NET: Integer ][ C, C++: unsigned long ][ C#: uint ]

Retrieves necessary information other than signal information.

Mask Bit Position

Hex Value

Data

Explanation

4 to 31

--

--

Reserved

3

8

0 F Non local lockout

1 F Local lockout

Local lockout status

2

4

0 F Local

1 F Remote

Remote/Local status

1

2

0 F Non listener

1 F Listener

Listener specified status

0

1

0 FNon talker

1 F Talker

Talker specified status

Return Value

Ret [ VB.NET: Integer ][ C, C++: long ][ C#: int ]

 

0

Normality completion

10001

Invalid ID was specified

10002

Driver can not be called

15674

Failed in making event object

Initial Value

hWnd

0

Window handler

NotifySignalMask

0

Signal mask

Remarks

 

Example

 

See Also

GpibGetNotifySignal, GpibSetNotifyMessage