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

ProtocolDirectOidRequestComplete 関数は、NdisDirectOidRequest 関数がNDIS_STATUS_PENDING返したプロトコル ドライバーによって開始される直接 OID 要求の処理を完了します。

構文

PROTOCOL_DIRECT_OID_REQUEST_COMPLETE ProtocolDirectOidRequestComplete;

VOID ProtocolDirectOidRequestComplete(
  [in] NDIS_HANDLE ProtocolBindingContext,
  [in] PNDIS_OID_REQUEST OidRequest,
  [in] NDIS_STATUS Status
)
{...}

パラメーター

[in] ProtocolBindingContext

プロトコル ドライバーがバインドごとの実行時状態を維持する、プロトコル ドライバーによって割り当てられたコンテキスト領域へのハンドル。 ドライバーは、NdisOpenAdapterEx 関数を呼び出すときに、このハンドルを提供しました。

[in] OidRequest

以前に NdisDirectOidRequest 関数に渡されたプロトコル ドライバー提供の NDIS_OID_REQUEST 構造体へのポインター。

[in] Status

要求の最終的な状態。 基になるドライバーまたは NDIS は、この最終的な状態を決定します。 このパラメーターは、OidRequestの情報で ProtocolDirectOidRequestComplete が行う を決定します。

戻り値

何一つ

備考

ProtocolDirectOidRequestComplete は省略可能な関数です。 プロトコル ドライバーが直接 OID 要求を使用しない場合は、呼び出し時に NULL を するこの関数のエントリ ポイントを設定できます。NdisRegisterProtocolDriver 関数を します。

ProtocolDirectOidRequestComplete では、Status パラメーターの入力値が次のように使用されます。

• 状態 がNDIS_STATUS_SUCCESSされている場合、BytesRead または BytesWritten メンバーの NDIS_OID_REQUEST 構造体は、NDIS または基になるドライバーによって設定されています。 これらの値は、設定操作で informationBuffer のバッファーから NIC に転送されたプロトコル ドライバー指定の情報の量、またはクエリ操作に応答して InformationBuffer で返された情報の量を指定します。

  プロトコル ドライバーがクエリを実行した場合、ProtocolDirectOidRequestComplete は、Oid メンバーの値に応じて、プロトコル ドライバーが決定する方法で、InformationBuffer で返されるデータを使用できます。

  たとえば、プロトコル ドライバーが最初にクエリ OID_GEN_MAXIMUM_SEND_PACKETS、ProtocolDirectOidRequestComplete 、ProtocolBindingContext 領域に状態変数を設定して、ドライバーが後続の呼び出しのために設定する未処理の送信の数を調整する場合があります。NdisSendNetBufferLists 関数を します。

• Status がNDIS_STATUS_INVALID_LENGTHまたはNDIS_STATUS_BUFFER_TOO_SHORTの場合、BytesNeeded メンバーは、要求された操作を実行するために必要な InformationBufferLength メンバーの OID 固有の値を指定します。

  このような状況では、ProtocolDirectOidRequestComplete は、要求に十分なバッファー領域を割り当て、必要な InformationBufferLength 値と同じ Oid 値を持つ別のNDIS_OID_REQUEST構造体を設定し、NdisDirectOidRequest 関数の呼び出しを再試行できます。

  ProtocolDirectOidRequestComplete は、NdisDirectOidRequest で説明されているように、他の特定のNDIS_STATUS_ Xxx 引数の要求再試行することもできます。

• 状態 が回復不可能なエラーであるNDIS_STATUS_ Xxx 値である場合、ProtocolDirectOidRequestComplete は、NDIS_OID_REQUEST構造体に割り当てられているメモリを解放し、ドライバーがバインディングを閉じるか、バインド固有の状態情報を調整して、バインドに対する継続的なネットワーク I/O 操作を処理するかを決定する必要があります。

NDIS は、IRQL = DISPATCH_LEVEL で ProtocolDirectOidRequestComplete < 呼び出します。

の例

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

PROTOCOL_DIRECT_OID_REQUEST_COMPLETE MyDirectOidRequestComplete;

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

_Use_decl_annotations_
VOID
 MyDirectOidRequestComplete(
    NDIS_HANDLE  ProtocolBindingContext,
    PNDIS_OID_REQUEST  OidRequest,
    NDIS_STATUS  Status
    )
  {...}

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

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

必要条件

関連項目

NDIS_OID_REQUEST

NdisDirectOidRequest の

NdisOpenAdapterEx の

NdisRegisterProtocolDriver の

OID_GEN_MAXIMUM_SEND_PACKETS