次の方法で共有

PROTOCOL_CM_MAKE_CALL コールバック関数 (ndis.h)

  • [アーティクル]

ProtocolCmMakeCall 関数は、仮想接続 (VC) のメディア固有のパラメーターを設定し、仮想接続をアクティブ化する必須の関数です。

メモPROTOCOL_CM_MAKE_CALL型を使用して関数を宣言する必要があります。 詳細については、次の例に関するセクションを参照してください。
 

構文

PROTOCOL_CM_MAKE_CALL ProtocolCmMakeCall;

NDIS_STATUS ProtocolCmMakeCall(
  [in]            NDIS_HANDLE CallMgrVcContext,
  [in, out]       PCO_CALL_PARAMETERS CallParameters,
  [in, optional]  NDIS_HANDLE NdisPartyHandle,
  [out, optional] PNDIS_HANDLE CallMgrPartyContext
)
{...}

パラメーター

[in] CallMgrVcContext

呼び出しマネージャーが VC ごとの状態を維持する、呼び出しマネージャーによって割り当てられたコンテキスト領域へのハンドルを指定します。 呼び出しマネージャーは、 ProtocolCoCreateVc 関数から NDIS にこのハンドルを提供しました。

[in, out] CallParameters

この発信呼び出しの接続指向クライアントによって指定されたパラメーターを含む CO_CALL_PARAMETERS構造体への ポインター。

[in, optional] NdisPartyHandle

NDIS によって提供されるハンドルを指定します。このハンドルは、マルチポイント仮想接続の初期パーティを一意に識別します。 このハンドルは呼び出しマネージャーに対して不透明であり、NDIS ライブラリ用に予約されています。 クライアントが発信マルチポイント呼び出しを設定していない場合、このハンドルは NULL です 。

[out, optional] CallMgrPartyContext

戻り時に、呼び出しマネージャーがマルチポイント呼び出しの初期パーティに関する状態を維持する、呼び出しマネージャーが指定したコンテキスト領域へのハンドルを指定します。 NdisPartyHandle が NULL の場合、このハンドルは NULL に設定する必要があります。

戻り値

ProtocolCmMakeCall は、その操作の状態を次のいずれかの値として返します。

リターン コード 説明
NDIS_STATUS_SUCCESS
 呼び出しマネージャーが呼び出しを行うために必要なリソースを正常に割り当て、ミニポート ドライバーとの仮想接続をアクティブ化できることを示します。
NDIS_STATUS_PENDING
 呼び出しマネージャーが非同期的に呼び出しを行う要求を完了することを示します。 呼び出しマネージャーは、呼び出しを行うためにすべての操作を完了したら、 NdisCmMakeCallComplete を呼び出して、この呼び出しが完了したことを NDIS に通知する必要があります。
NDIS_STATUS_RESOURCES
 呼び出しマネージャーが、クライアントの要求に応じて仮想接続をアクティブ化するためのリソースを割り当てたり初期化したりできなかったことを示します。
NDIS_STATUS_NOT_SUPPORTED
 呼び出し元が CallParameters で指定された呼び出しパラメーターで無効または使用できない機能を要求したため、呼び出しマネージャーが仮想接続をアクティブにできなかったことを示します。

注釈

ProtocolCmMakeCall に明示的な NdisPartyHandle が指定されている場合、この VC はマルチポイント呼び出し用にクライアントによって作成されました。 呼び出しマネージャーは、状態情報を維持し、マルチポイント呼び出しを制御するために必要なリソースを割り当てて初期化する必要があります。 このようなリソースには、メモリ バッファー、データ構造、イベント、およびその他の同様のリソースが含まれますが、これらに限定されません。 呼び出しマネージャーが状態領域に必要なリソースを割り当てまたは初期化できない場合は、NDIS_STATUS_RESOURCESを使用して NDIS に制御を返す必要があります。

ProtocolCmMakeCall は 、必要に応じてネットワーク制御デバイスまたはその他のメディア固有のアクターと通信し、 CallParameters で指定された呼び出しパラメーターに基づいてローカル ノードとリモート ノードの間に接続を確立します。 このようなアクションには、スイッチング ハードウェアとの通信、ネットワーク制御ステーションとの通信、またはネットワーク メディアに応じたその他のアクションが含まれますが、これらに限定されません。

ネットワーク ハードウェア (ネットワーク スイッチなど) との通信に呼び出しマネージャーが必要な場合は、 ProtocolBindAdapterEx 関数で確立したネットワークコントロール デバイスへの仮想接続を使用する必要があります。 呼び出しマネージャーは、 NdisCoSendNetBufferLists を呼び出すことによって、ミニポート ドライバーを介してネットワーク ハードウェアと通信します。 統合された呼び出し管理のサポートを持つミニポート ドライバーは NdisCoSendNetBufferLists を呼び出すのではなく、データ自体を送信します。

通話マネージャーがメディアで必要に応じてネットワーク ハードウェアと必要なすべての通信を行った後、呼び出しマネージャーは NdisCmActivateVc を呼び出す必要があります。

この呼び出しがマルチポイント呼び出しの場合、呼び出しマネージャーがネットワーク ハードウェアと通信し、呼び出しパラメーターを検証し、パーティごとの状態データを割り当て、初期化した後、コントロールを NDIS に返す前に、その状態ブロックのアドレスをハンドル CallMgrPartyContext に設定する必要があります。 ハンドルは、ハンドルを逆参照し、状態ブロックへのポインターをハンドルの値として格納することによって設定されます。 例:

*CallMgrPartyContext = SomeBuffer ;

ProtocolCmMakeCall がネットワークに必要な操作を完了し、VC が NdisCmActivateVc を介して正常にアクティブ化された場合、ProtocolCmMakeCall は、STATUS_SUCCESSの状態でできるだけ早く制御を返す必要があります。

ProtocolCmMakeCall が NDIS に制御を返した後、呼び出しマネージャーは、この呼び出しに対してそれ以上のアクションを実行して設定しない必要があります。 ProtocolCmMakeCall は、クライアントがこの VC 上のネットワーク経由でデータ転送を行うことができるように、接続を確立する役割を担います。 ただし、呼び出しマネージャーを後で呼び出して通話のサービス品質を変更し、マルチポイント VC の場合はパーティを追加または削除し、最終的にこの呼び出しを終了することができます。

例

ProtocolCmMakeCall 関数を定義するには、まず、定義する関数の種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーの関数型のセットが用意されています。 関数の種類を使用して関数を宣言すると、 ドライバーのコード分析、 静的ドライバー検証ツール (SDV)、およびその他の検証ツールでエラーが検出され、Windows オペレーティング システム用のドライバーを記述するための要件になります。

たとえば、" MyCmMakeCall" という名前の ProtocolCmMakeCall 関数を定義するには、次のコード例に示すように 、PROTOCOL_CM_MAKE_CALL 型を使用します。

PROTOCOL_CM_MAKE_CALL MyCmMakeCall;

次に、次のように関数を実装します。

_Use_decl_annotations_
NDIS_STATUS
 MyCmMakeCall(
    NDIS_HANDLE  CallMgrVcContext,
    PCO_CALL_PARAMETERS  CallParameters,
    NDIS_HANDLE  NdisPartyHandle,
    PNDIS_HANDLE  CallMgrPartyContext
    )
  {...}

PROTOCOL_CM_MAKE_CALL関数の種類は、Ndis.h ヘッダー ファイルで定義されています。 コード分析ツールを実行するときにエラーをより正確に識別するには、 Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations注釈を使用すると、ヘッダー ファイル内のPROTOCOL_CM_MAKE_CALL関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「NDIS ドライバーの関数 ロール型を使用して関数を宣言する」を参照してください。

Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「ProtocolCmMakeCall (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「ProtocolCmMakeCall (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム Windows
ヘッダー ndis.h (Ndis.h を含む)
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

NdisClMakeCall

NdisCmActivateVc

NdisCmMakeCallComplete

ProtocolCoCreateVc