Win32 API 日本語リファレンス
ホームDevices.Fax › IFaxDevice

IFaxDevice

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID49306c59-b52e-4867-9df4-ca5841c956d0継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 26

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Id(INT* plId)
plIdINT*outファクスデバイスを一意に識別するIDを受け取るINTポインタ。
vtbl 8 HRESULT get_DeviceName(LPWSTR* pbstrDeviceName)
pbstrDeviceNameLPWSTR*outファクスデバイスの名前を受け取るBSTRポインタ。
vtbl 9 HRESULT get_ProviderUniqueName(LPWSTR* pbstrProviderUniqueName)
pbstrProviderUniqueNameLPWSTR*outこのデバイスを提供するプロバイダの一意名を受け取るBSTRポインタ。
vtbl 10 HRESULT get_PoweredOff(VARIANT_BOOL* pbPoweredOff)
pbPoweredOffVARIANT_BOOL*outデバイスの電源が切れているかを受け取るVARIANT_BOOLポインタ。
vtbl 11 HRESULT get_ReceivingNow(VARIANT_BOOL* pbReceivingNow)
pbReceivingNowVARIANT_BOOL*outデバイスが現在受信中かを受け取るVARIANT_BOOLポインタ。
vtbl 12 HRESULT get_SendingNow(VARIANT_BOOL* pbSendingNow)
pbSendingNowVARIANT_BOOL*outデバイスが現在送信中かを受け取るVARIANT_BOOLポインタ。
vtbl 13 HRESULT get_UsedRoutingMethods(VARIANT* pvUsedRoutingMethods)
pvUsedRoutingMethodsVARIANT*outこのデバイスで有効なルーティングメソッドのGUID配列を格納したVARIANTを受け取るポインタ。
vtbl 14 HRESULT get_Description(LPWSTR* pbstrDescription)
pbstrDescriptionLPWSTR*outデバイスの説明文字列を受け取るBSTRポインタ。
vtbl 15 HRESULT put_Description(LPWSTR bstrDescription)
bstrDescriptionLPWSTRinデバイスの説明文字列を設定するBSTR。
vtbl 16 HRESULT get_SendEnabled(VARIANT_BOOL* pbSendEnabled)
pbSendEnabledVARIANT_BOOL*outこのデバイスで送信が有効かを受け取るVARIANT_BOOLポインタ。
vtbl 17 HRESULT put_SendEnabled(VARIANT_BOOL bSendEnabled)
bSendEnabledVARIANT_BOOLinこのデバイスの送信有効/無効を設定するVARIANT_BOOL。
vtbl 18 HRESULT get_ReceiveMode(FAX_DEVICE_RECEIVE_MODE_ENUM* pReceiveMode)
pReceiveModeFAX_DEVICE_RECEIVE_MODE_ENUM*out受信モードを表すFAX_DEVICE_RECEIVE_MODE_ENUM値を受け取るポインタ。自動/手動/無効を示す。
vtbl 19 HRESULT put_ReceiveMode(FAX_DEVICE_RECEIVE_MODE_ENUM ReceiveMode)
ReceiveModeFAX_DEVICE_RECEIVE_MODE_ENUMin受信モードを設定するFAX_DEVICE_RECEIVE_MODE_ENUM値。自動/手動/無効を指定する。
vtbl 20 HRESULT get_RingsBeforeAnswer(INT* plRingsBeforeAnswer)
plRingsBeforeAnswerINT*out自動応答までの呼出回数を受け取るINTポインタ。
vtbl 21 HRESULT put_RingsBeforeAnswer(INT lRingsBeforeAnswer)
lRingsBeforeAnswerINTin自動応答までの呼出回数を設定するINT。
vtbl 22 HRESULT get_CSID(LPWSTR* pbstrCSID)
pbstrCSIDLPWSTR*outこのデバイスの被呼局識別(CSID)文字列を受け取るBSTRポインタ。
vtbl 23 HRESULT put_CSID(LPWSTR bstrCSID)
bstrCSIDLPWSTRinこのデバイスの被呼局識別(CSID)文字列を設定するBSTR。
vtbl 24 HRESULT get_TSID(LPWSTR* pbstrTSID)
pbstrTSIDLPWSTR*outこのデバイスの送信局識別(TSID)文字列を受け取るBSTRポインタ。
vtbl 25 HRESULT put_TSID(LPWSTR bstrTSID)
bstrTSIDLPWSTRinこのデバイスの送信局識別(TSID)文字列を設定するBSTR。
vtbl 26 HRESULT Refresh()
vtbl 27 HRESULT Save()
vtbl 28 HRESULT GetExtensionProperty(LPWSTR bstrGUID, VARIANT* pvProperty)
bstrGUIDLPWSTRin取得対象の拡張プロパティを識別するGUID文字列を指定するBSTR。
pvPropertyVARIANT*out拡張プロパティの値(通常はバイト配列)を格納したVARIANTを受け取るポインタ。
vtbl 29 HRESULT SetExtensionProperty(LPWSTR bstrGUID, VARIANT vProperty)
bstrGUIDLPWSTRin設定対象の拡張プロパティを識別するGUID文字列を指定するBSTR。
vPropertyVARIANTin設定する拡張プロパティの値(通常はバイト配列)を格納したVARIANT。
vtbl 30 HRESULT UseRoutingMethod(LPWSTR bstrMethodGUID, VARIANT_BOOL bUse)
bstrMethodGUIDLPWSTRin有効/無効を切り替えるルーティングメソッドのGUID文字列を指定するBSTR。
bUseVARIANT_BOOLinそのルーティングメソッドを使用するかを指定するVARIANT_BOOL。VARIANT_TRUEで有効化。
vtbl 31 HRESULT get_RingingNow(VARIANT_BOOL* pbRingingNow)
pbRingingNowVARIANT_BOOL*outデバイスの回線が現在着信(呼出)中かを受け取るVARIANT_BOOLポインタ。
vtbl 32 HRESULT AnswerCall()

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_IFaxDevice "{49306C59-B52E-4867-9DF4-CA5841C956D0}"
#usecom global IFaxDevice IID_IFaxDevice "{}"
#comfunc global IFaxDevice_get_Id                  7 var
#comfunc global IFaxDevice_get_DeviceName          8 var
#comfunc global IFaxDevice_get_ProviderUniqueName  9 var
#comfunc global IFaxDevice_get_PoweredOff          10 var
#comfunc global IFaxDevice_get_ReceivingNow        11 var
#comfunc global IFaxDevice_get_SendingNow          12 var
#comfunc global IFaxDevice_get_UsedRoutingMethods  13 var
#comfunc global IFaxDevice_get_Description         14 var
#comfunc global IFaxDevice_put_Description         15 wstr
#comfunc global IFaxDevice_get_SendEnabled         16 var
#comfunc global IFaxDevice_put_SendEnabled         17 int
#comfunc global IFaxDevice_get_ReceiveMode         18 var
#comfunc global IFaxDevice_put_ReceiveMode         19 int
#comfunc global IFaxDevice_get_RingsBeforeAnswer   20 var
#comfunc global IFaxDevice_put_RingsBeforeAnswer   21 int
#comfunc global IFaxDevice_get_CSID                22 var
#comfunc global IFaxDevice_put_CSID                23 wstr
#comfunc global IFaxDevice_get_TSID                24 var
#comfunc global IFaxDevice_put_TSID                25 wstr
#comfunc global IFaxDevice_Refresh                 26
#comfunc global IFaxDevice_Save                    27
#comfunc global IFaxDevice_GetExtensionProperty    28 wstr,var
#comfunc global IFaxDevice_SetExtensionProperty    29 wstr,int
#comfunc global IFaxDevice_UseRoutingMethod        30 wstr,int
#comfunc global IFaxDevice_get_RingingNow          31 var
#comfunc global IFaxDevice_AnswerCall              32
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。