phoneDevSpecific 関数 (tapi.h)

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

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

構文

LONG phoneDevSpecific(
  HPHONE hPhone,
  LPVOID lpParams,
  DWORD  dwSize
);

パラメーター

hPhone

電話デバイスへのハンドル。

lpParams

パラメーターブロックを保持するために使用されるメモリ領域へのポインター。その解釈はデバイス固有です。パラメーターブロックの内容は、TAPI によってサービスプロバイダー間で変更されずに渡されます。

dwSize

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

戻り値

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

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

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

注釈

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

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