NdisDirectOidRequest 関数 (ndis.h)
NdisDirectOidRequest 関数は、アダプターの機能または状態を照会したり、アダプターの状態を設定したりするために、基になるドライバーに直接 OID 要求を転送します。
構文
NDIS_STATUS NdisDirectOidRequest(
[in] NDIS_HANDLE NdisBindingHandle,
[in] PNDIS_OID_REQUEST OidRequest
);
パラメーター
[in] NdisBindingHandle
バインドのターゲット ミニポート アダプターを識別する NdisOpenAdapterEx 関数が返すハンドル。
[in] OidRequest
アダプターの 状態を照会 するか、アダプターの状態を設定するために、特定のOID_Xxx コードで要求される操作を指定するNDIS_OID_REQUEST構造体へのポインター。
戻り値
基になるドライバーは、NdisDirectOidRequest が返すNDIS_STATUS_XXX コードを決定しますが、通常は次のいずれかの値です。
| リターン コード | 説明 |
|---|---|
|
要求操作が正常に完了しました。 |
|
要求は非同期的に処理されており、NDIS は呼び出し元の を呼び出します。要求が完了したときの ProtocolDirectOidRequestComplete 関数。 |
|
OidRequest でNDIS_OID_REQUEST構造化バッファーの Oid メンバーで指定されたOID_Xxx コードが無効であるか、基になるドライバーによってサポートされていません。 |
|
OidRequest のNDIS_OID_REQUEST構造化バッファーの InformationBufferLength メンバーで指定された値が、指定されたOID_Xxx コードの要件と一致しませんでした。 情報バッファーが小さすぎる場合、BytesNeeded メンバーには NdisDirectOidRequest からの戻り時に InformationBufferLength の正しい値が含まれます。 |
|
指定されたNDIS_OID_REQUEST構造体の InformationBuffer で指定されたデータが、指定されたOID_Xxx コードに対して無効でした。 |
|
基になるドライバーは、要求された操作をサポートしていません。 NdisDirectOidRequest の場合、呼び出し元のドライバーが を登録していない場合、NDIS は、この状態を返すこともできます。 ProtocolDirectOidRequestComplete 関数。 |
|
リソース不足のため、要求を満たできませんでした。 通常、この戻り値は、メモリの割り当て試行が失敗したことを示しますが、後で送信された同じ要求が同じ理由で失敗したとは限りません。 |
|
基になるドライバーは、要求された操作 (通常は NIC のセット) を試行しましたが、失敗しました。 たとえば、マルチキャスト アドレスを設定しようとすると、この値が返される可能性があります。 |
|
閉じる操作が進行中のため、基になるドライバーが要求された操作に失敗しました。 |
|
基になるミニポート ドライバーは、現在影響を受ける NIC をリセットしているため、現時点では要求を満たすことはできません。 呼び出し元の ProtocolStatusEx 関数は、リセットが進行中であることを示すために、NDIS_STATUS_RESET_STARTで または 呼び出されます。 この戻り値は、後で送信された同じ要求が同じ理由で失敗することを必ずしも示すわけではありません。 |
|
通常、この値は非固有の既定値であり、基になるドライバーが要求に失敗する原因となったより具体的な NDIS_STATUS_Xxx 値がない場合に返されます。 |
注釈
NdisDirectOidRequest 関数は、一般的な OID 要求には使用できません。 一般的な OID 要求の場合は、代わりに NdisOidRequest 関数を使用します。 NdisDirectOidRequest は、NDIS が直接 OID インターフェイスでの使用をサポートする OID にのみ使用できます。 たとえば、次の OID を使用できます。
OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SAプロトコル ドライバーは、指定された OID に関連付けられている情報バッファーを保持するのに十分なメモリを割り当てる必要があります。 ドライバーは、NdisDirectOidRequest を呼び出す前に OidRequest パラメーターでバッファーを割り当てて設定する必要もあります。 基になるドライバーは要求の処理中に発生した IRQL で実行されるため、両方のバッファーを非ページ プールから割り当てる必要があります。
NdisDirectOidRequest は、基になるドライバーに要求を転送するか、要求自体を処理します。 次の下位ドライバーが NDIS 中間ドライバーの場合、中間ドライバーは、上位レベルのドライバーが最初に送信した要求を完了する前に、独自の OID 固有の要求で NdisDirectOidRequest を呼び出すことができます。
NdisDirectOidRequest を呼び出すドライバーは、 を登録する必要があります。 ProtocolDirectOidRequestComplete 関数。
直接 OID 要求インターフェイスは、一般的な OID 要求インターフェイスに似ています。 一般的な要求の発行の詳細については、「 NdisOidRequest」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | NDIS 6.1 以降でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |