NdisCompleteBindAdapterEx 関数 (ndis.h)

  • [アーティクル]

プロトコル ドライバーは NdisCompleteBindAdapterEx 関数を呼び出して、ドライバーの ProtocolBindAdapterEx 関数がNDIS_STATUS_PENDING返されるバインド操作を完了します。

構文

void NdisCompleteBindAdapterEx(
       NDIS_HANDLE BindAdapterContext,
  [in] NDIS_STATUS Status
);

パラメーター

BindAdapterContext

NDIS が の BindContext パラメーターに渡したハンドル ProtocolBindAdapterEx 関数。

[in] Status

完了したバインド操作の最終的な状態。 このパラメーターには、次のいずれかの値を指定できます。

NDIS_STATUS_SUCCESS

ドライバーは、基になる NIC へのバインドを正常に完了しました。

NDIS_STATUS_XXXまたはNTSTATUS_XXX

プロトコル ドライバーによるバインドの設定に失敗したか、プロトコル ドライバーがネットワーク I/O 操作を実行するために必要なリソースを割り当てませんでした。 通常、このようなエラー状態は 、NdisXxx 関数またはカーネル モード サポート ルーチンから伝達されます。

戻り値

なし

解説

プロトコル ドライバーが ProtocolBindAdapterEx 関数からNDIS_STATUS_PENDINGを返す場合、そのドライバーはバインド操作の完了後に NdisCompleteBindAdapterEx を呼び出す必要があります。

開いている操作が成功した場合、プロトコル ドライバーは、基になるドライバーからの受信通知を受け入れ、バインドに対する送信要求と OID 要求を開始する準備ができています。 ドライバーがエラー状態で NdisCompleteBindAdapterEx を呼び出した場合、バインドの試行は失敗し、ドライバーはバインドを確立するために割り当てられたリソースを解放しました。

要件

要件 値
サポートされている最小のクライアント NDIS 6.0 以降でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 Irql_Protocol_Driver_Function(ndis)

こちらもご覧ください

NdisOpenAdapterEx

ProtocolBindAdapterEx