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) |