linePickup 関数 (tapi.h)

[アーティクル]
08/26/2023

linePickup 関数は、指定された宛先アドレスで警告する呼び出しを取得し、ピックアップされた呼び出しの呼び出しハンドルを返します。 lpszDestAddress パラメーターに対して NULL で呼び出された場合、グループピックアップが実行されます。デバイスで必要な場合、 lpszGroupID は、アラートステーションが属するグループ識別子を指定します。

構文

LONG linePickup(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCSTR  lpszDestAddress,
  LPCSTR  lpszGroupID
);

パラメーター

hLine

呼び出しを受け取るオープンラインデバイスへのハンドル。

dwAddressID

ピックアップの発信元となる hLine のアドレス。アドレス識別子は、アドレスに完全に関連付けられます。識別子は、オペレーティングシステムのアップグレード間で一定のままです。

lphCall

選択した呼び出しへのハンドルが返されるメモリの場所へのポインター。アプリケーションは、呼び出しの最初の唯一の所有者です。

lpszDestAddress

呼び出しを取得するアドレスを含む null で終わる文字バッファーへのポインター。アドレスは標準のダイヤル可能なアドレス形式です。

lpszGroupID

アラートステーションが属するグループ識別子を含む null で終わる文字バッファーへのポインター。このパラメーターは、現在のピックアップグループの外部で呼び出しを取得するために、一部のスイッチで必要です。

lpszGroupID パラメーターは、lpszDestAddress の NULL ポインターを使用してそれ自体で指定できます。または、デバイスで必要な場合は、lpszDestAddress に加えて lpszGroupID を指定することもできます。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。関数が成功した場合は、対応するLINE_REPLY メッセージの dwParam2 パラメーターは 0、エラーが発生した場合は負のエラー番号です。可能な戻り値は次のとおりです。

LINEERR_INVALADDRESS、LINEERR_NOMEM、LINEERR_INVALADDRESSID、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALGROUPID、LINEERR_OPERATIONFAILED、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED。

注釈

呼び出しが正常に取得されると、呼び出し状態の変更に関する LINE_CALLSTATE メッセージによってアプリケーションに通知されます。 LINECALLINFO 構造体は、取得された呼び出しに関する情報を提供します。通話の理由が ピックアップとして一覧表示されます。この構造体は、 lineGetCallInfo を使用して使用できます。

LINEADDRCAPFLAGS_PICKUPCALLWAITが TRUE の場合、 linePickup を使用して、ユーザーがコール待機シグナルを明確に検出したが、プロバイダーが検出を実行できない呼び出しを取得できます。これにより、サービスプロバイダーが呼び出し待機シグナルを検出できなかった場合でも、ユーザーは待機中の呼び出しに "応答" するメカニズムが提供されます。呼び出し待機呼び出しを取得するには、 lpszDestAddress と lpszGroupID ポインターパラメーターの両方が NULL である必要があります。 linePickup 関数は、待機中の呼び出しの新しい呼び出しハンドルを作成し、そのハンドルをユーザーに渡します。 dwAddressID パラメーターは、ほとんどの場合 0 です (特に単一行住宅の場合)。

linePickup を使用して 2 番目の呼び出しを取得した後、lineSwapHold を使用してそれらを切り替えることができます。 lineDrop 関数を使用して、1 つを削除 (およびもう一方に切り替える) などを行うことができます。ユーザーが現在の呼び出しを削除して 2 番目の呼び出しを取得する場合は、通話待機中のビープ音が鳴ったときに lineDrop を呼び出し、2 回目の呼び出しが呼び出されるまで待機してから、新しい呼び出しハンドルで lineAnswer を呼び出す必要があります。 LINEADDRESSSTATUS の dwAddressFeatures メンバーのLINEADDRFEATURE_PICKUP フラグは、ピックアップが実際に可能なタイミングを示します。