FAX サービスは、FAX サービス プロバイダー (FSP) DLL を読み込んだ後、サービスが開始されるたびに FaxDevInitialize 関数を呼び出します。 各 FSP は FaxDevInitialize 関数をエクスポートする必要があります。
構文
BOOL FaxDevInitialize(
[in] HLINEAPP LineAppHandle,
[in] HANDLE HeapHandle,
[out] PFAX_LINECALLBACK *LineCallbackFunction,
[in] PFAX_SERVICE_CALLBACK FaxServiceCallback
);
パラメーター
[in] LineAppHandle
種類: HLINEAPP
FAX サービスの TAPI への登録に対するハンドルを指定します。 詳細については、TAPI 2.x lineInitializeEx 関数を 参照してください。
[in] HeapHandle
型: HANDLE
FSP がすべてのメモリ割り当てに使用する必要があるヒープへのハンドルを指定します。
[out] LineCallbackFunction
種類: PFAX_LINECALLBACK*
TAPI 行コールバック関数へのポインターを受け取る変数へのポインター。
[in] FaxServiceCallback
種類: PFAX_SERVICE_CALLBACK
サービス コールバック関数へのポインター。 この機能は現在使用されていませんが、この機能は今後のバージョンの FAX サービスで使用できる予定であり、FAX サービスから FSP に機能を提供する予定です。
戻り値
種類: BOOL
関数が成功した場合、戻り値は 0 以外の値になります。
関数が失敗した場合は、0 を返します。 この場合、FAX サービスの現在のインスタンスでは、この FSP は使用されません。 この FSP でサポートされているすべてのデバイスは、FAX を送受信できません。 拡張エラー情報を取得するために、FAX サービスは GetLastError を呼び出します。
解説
FSP は、必要な初期化を実行して FaxDevInitialize 関数に応答する必要があります。
FSP は、LineCallbackFunction パラメーターで指定された FaxLineCallback 関数を指定する必要があります。 FAX サービスは、TAPI イベントを FSP に配信する必要がある場合に、この関数を呼び出します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | faxdev.h |