TSPI_phoneDevSpecific関数 (tspi.h)

TSPI_phoneDevSpecific関数は、テレフォニー API 実装が他の操作で説明されていない機能を提供できるようにするための一般的な拡張メカニズムとして使用されます。 これらの拡張機能の意味は、デバイス固有です。

構文

LONG TSPIAPI TSPI_phoneDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  LPVOID        lpParams,
  DWORD         dwSize
);

パラメーター

dwRequestID

非同期要求の識別子。

hdPhone

デバイス固有の操作を実行する電話機へのハンドル。

lpParams

パラメーター ブロックを保持するために使用されるメモリ領域へのポインター。 その解釈はデバイス固有です。 lpParams パラメーターにはポインターを含めないようにしてください。 TSPI_phoneDevSpecificからアプリケーションに情報を取得するために、サービス プロバイダーは情報を含むPHONE_DEVSPECIFIC メッセージを送信します。

dwSize

パラメーター ブロック領域のサイズ (バイト単位)。

戻り値

エラーが発生した場合は 、dwRequestID またはエラー番号を返します。 対応するASYNC_COMPLETIONの lResult 実際のパラメーターは、関数が成功した場合は 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_NOMEM、PHONEERR_OPERATIONFAILED、PHONEERR_RESOURCEUNAVAIL。

解説

追加の戻り値は、デバイス固有です。

この操作では、ジェネリック パラメーター プロファイルが提供されます。 パラメーター ブロックの解釈は、デバイス固有です。 デバイス固有の表示と応答では、 PHONE_DEVSPECIFIC メッセージを使用する必要があります。

この関数は、TAPI phoneDevSpecific 関数を呼び出したアプリケーションに直接応答して呼び出されます。 TAPI は、TAPI レベルで使用される hPhone パラメーターを、TSPI レベルで使用される対応する hdPhone パラメーターに変換します。 lpParams バッファーは、変更されていない状態で渡されます。

サービス プロバイダーは、この操作で使用するパラメーターを定義することで、デバイス固有の関数へのアクセスを提供できます。 これらのデバイス固有の拡張機能を使用するアプリケーションは、定義されている拡張機能について説明しているデバイス固有 (ベンダー固有) のドキュメントを参照する必要があります。

要件

関連項目

ASYNC_COMPLETION

PHONE_DEVSPECIFIC