次の方法で共有

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

  • [アーティクル]

ProtocolCmAddParty 関数は必須の関数です。 ProtocolCmAddParty は、既存のマルチポイント呼び出しにパーティーを追加し、新しいパーティーの状態データを格納して、パーティーを呼び出しに追加するようにメディア固有のパラメーターを設定します。

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

構文

PROTOCOL_CM_ADD_PARTY ProtocolCmAddParty;

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

パラメーター

[in] CallMgrVcContext

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

[in, out] CallParameters

既存の呼び出しに追加されるパーティの、接続指向クライアントによって指定されたパラメーターを含む CO_CALL_PARAMETERS 構造体へのポインター。

[in] NdisPartyHandle

既存の仮想接続に追加するマルチポイント パーティを一意に識別する、NDIS によって提供されるハンドルを指定します。 このハンドルは呼び出しマネージャーに対して不透明であり、NDIS ライブラリ用に予約されています。

[out] CallMgrPartyContext

呼び出しマネージャーがマルチポイント呼び出しに対してこのパーティに関する状態を維持する、呼び出しマネージャーが指定したコンテキスト領域へのハンドルを返す場合に指定します。

戻り値

ProtocolCmAddParty は、次のいずれかの操作の状態を返します。

リターン コード 形容
NDIS_STATUS_SUCCESS
 通話マネージャーが、パーティーに関する状態を維持するために必要なリソースを正常に割り当て、通話にパーティーを正常に追加したことを示します。
NDIS_STATUS_PENDING
 通話マネージャーがパーティーを非同期的に追加する要求を完了することを示します。 呼び出しマネージャーは、パーティーを追加するためのすべての操作を完了したら、ndiscmAddPartyComplete を呼び出して、この操作が完了したことを NDIS に通知する必要があります。
NDIS_STATUS_RESOURCES
 通話マネージャーが、接続にパーティーを追加するためにリソースを割り当てたり初期化したりできなかったことを示します。
NDIS_STATUS_NOT_SUPPORTED
 呼び出し元が CallParameters の呼び出しパラメーターで無効または使用不可の機能を要求したため、またはこの呼び出しマネージャー でサポートされているメディアの種類がマルチポイント呼び出しをサポートしていないため、通話マネージャーがマルチポイント呼び出しにパーティーを追加できなかったことを示します。

備考

ProtocolCmAddParty は、呼び出しマネージャーが、マルチポイント呼び出しに追加 NdisPartyHandleで指定されたパーティに関する状態情報を維持するために必要な動的リソースと構造体の割り当てを実行します。 このようなリソースには、メモリ バッファー、データ構造、イベント、およびその他の同様のリソースが含まれますが、これらに限定されません。 また、呼び出しマネージャーは、この関数で関連するパーティごとの構造体を初期化する必要があります。

呼び出しマネージャーが割り当てるパーティごとの状態領域では、呼び出しマネージャー は、将来の呼び出しで参照できるように、NdisPartyHandle で指定されたハンドルを格納 必要があります。 呼び出しマネージャーが割り当てられ、パーティごとの状態領域の初期化が完了したら、NDIS に制御を返す前に、状態バッファーのアドレスを CallMgrPartyContext ハンドルとして設定する必要があります。 これを行うには、ハンドルを逆参照し、状態バッファーへのポインターをハンドルの値として格納します。 例えば：

*CallMgrPartyContext = SomeBuffer;

呼び出しマネージャーは、必要に応じて、ネットワーク ハードウェアまたはその他のメディア固有のアクターと必要な通信を実行し、callParameters の呼び出しパラメーターで指定されたパーティを既存のマルチポイント呼び出し 追加します。

の例

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

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

MINIPORT_ADD_DEVICE MyCmAddParty;

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

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

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

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

必要条件

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

関連項目

NdisClAddParty

ProtocolClAddPartyComplete