次の方法で共有

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
 呼び出しマネージャーが非同期的に呼び出しを行う要求を完了することを示します。 呼び出しマネージャーは、呼び出しを行うためにすべての操作を完了したら、この呼び出しが完了したことを NDIS に通知 NdisCmMakeCallComplete を呼び出す必要があります。
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) を参照) でサポートされています。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ndis.h (Ndis.h を含む)
IRQL <= DISPATCH_LEVEL

関連項目

NdisClMakeCall の

NdisCmActivateVc の

NdisCmMakeCallComplete の

ProtocolCoCreateVc