PROTOCOL_CM_MAKE_CALL コールバック関数 (ndis.h)
ProtocolCmMakeCall 関数は、仮想接続 (VC) のメディア固有のパラメーターを設定し、仮想接続をアクティブ化する必須の関数です。
構文
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 は、その操作の状態を次のいずれかの値として返します。
| リターン コード | 説明 |
|---|---|
|
呼び出しマネージャーが呼び出しを行うために必要なリソースを正常に割り当て、ミニポート ドライバーとの仮想接続をアクティブ化できることを示します。 |
|
呼び出しマネージャーが非同期的に呼び出しを行う要求を完了することを示します。 呼び出しマネージャーは、呼び出しを行うためにすべての操作を完了したら、 NdisCmMakeCallComplete を呼び出して、この呼び出しが完了したことを NDIS に通知する必要があります。 |
|
呼び出しマネージャーが、クライアントの要求に応じて仮想接続をアクティブ化するためのリソースを割り当てたり初期化したりできなかったことを示します。 |
|
呼び出し元が 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 |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示