2.2.46 _FAX_PORT_INFO_EXW

  • Article

The _FAX_PORT_INFO_EXW data type is the custom-marshaled variant of the FAX_PORT_INFO_EXW (section 2.2.45) structure. This data type is used for FAX_EnumPortsEx (section 3.1.4.1.29) and FAX_GetPortEx (section 3.1.4.1.52).

This data structure is custom marshaled as follows and uses the custom-marshaling rules defined in section 2.2.1.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Fixed_Portion (48 bytes)

...

...

...

Variable_Data (variable)

...

Fixed_Portion (48 bytes):


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

dwSizeOfStruct

dwDeviceID

lpcwstrDeviceNameOffset

lpwstrDescriptionOffset

lpcwstrProviderNameOffset

lpcwstrProviderGUIDOffset

bSend

ReceiveMode

dwStatus

dwRings

lpwstrCsidOffset

lpwstrTsidOffset

dwSizeOfStruct (4 bytes): A DWORD ([MS-DTYP] section 2.2.9) value that holds the size of the Fixed_Portion block, in bytes. This value MUST be 48 bytes.

dwDeviceID (4 bytes): A DWORD that holds the line identifier for the specified fax device (port).

lpcwstrDeviceNameOffset (4 bytes): Offset to the lpcwstrDeviceName field in the Variable_Data block.

lpwstrDescriptionOffset (4 bytes): Offset to the lpcwstrDescription field in the Variable_Data block.

lpcwstrProviderNameOffset (4 bytes): Offset to the lpcwstrProviderName field in the Variable_Data block

lpcwstrProviderGUIDOffset (4 bytes): Offset to the lpcwstrProviderGUID field in the Variable_Data block.

bSend (4 bytes): A Boolean value that indicates whether the fax device is enabled to send faxes.

ReceiveMode (4 bytes): An FAX_ENUM_DEVICE_RECEIVE_MODE (section 2.2.55) enumerated value that indicates whether the fax device is enabled to receive faxes and whether the calls are manually or automatically answered.

dwStatus (4 bytes): A DWORD that holds the current status of the device. It SHOULD contain any combination of values from the FAX_ENUM_DEVICE_STATUS (section 2.2.64) enumeration or 0 (meaning: status unknown).

dwRings (4 bytes): A DWORD that holds the number of times an incoming fax call rings before the specified device answers the call.

lpwstrCsidOffset (4 bytes): Offset to the lpcwstrCsid field in the Variable_Data block

lpwstrTsidOffset (4 bytes): Offset to the lpcwstrTsid field in the c block.

Variable_Data (variable):


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

lpcwstrDeviceName (variable)

...

lpwstrDescription (variable)

...

lpcwstrProviderName (variable)

...

lpcwstrProviderGUID (variable)

...

lpwstrCsid (variable)

...

lpwstrTsid (variable)

...

lpcwstrDeviceName (variable): A null-terminated character string that holds the name of the fax device.

lpwstrDescription (variable): A null-terminated character string that holds the description of the fax device. The length of this string MUST NOT exceed MAX_FAX_STRING_LEN (section 2.2.86) characters, including the length of the terminating null character.

lpcwstrProviderName (variable): A null-terminated character string that holds the name of the fax device provider.

lpcwstrProviderGUID (variable): A null-terminated character string that holds the GUID of the fax device provider.

lpwstrCsid (variable): A null-terminated character string that holds the called subscriber identifier for faxes sent using this device. This identifier can be a telephone number.

lpwstrTsid (variable): A null-terminated character string that holds the transmitting subscriber identifier for faxes sent using this device. This identifier can be a telephone number.