NdisMGetOffloadHandlers 関数 (ndischimney.h)
[TCP のチムニー オフロード機能は非推奨であり、使用しないでください。]
この関数は、特定のチムニー型の NDIS 関数のエントリ ポイントを取得します。
構文
NDIS_STATUS NdisMGetOffloadHandlers(
[in] IN NDIS_HANDLE NdisMiniportHandle,
[in] IN NDIS_CHIMNEY_OFFLOAD_TYPE ChimneyType,
[out] OUT PNDIS_OFFLOAD_EVENT_HANDLERS *OffloadHandlers
);
パラメーター
[in] NdisMiniportHandle
オフロード ターゲットがアダプターのこのインスタンスに関する状態情報を保持するオフロード ターゲット割り当てコンテキスト領域へのハンドル。 オフロード ターゲットは、呼び出すときに NDIS にこのハンドルを提供しました NdisMSetMiniportAttributes からミニポートInitializeEx 関数を します。
[in] ChimneyType
次のNDIS_CHIMNEY_OFFLOAD_TYPE値のいずれかである、チムニータイプ:
NdisTcpChimneyOffload
TCP のチムニー オフロードの種類。
他のすべてのNDIS_CHIMNEY_OFFLOAD_TYPE値は現在予約されています。
[out] OffloadHandlers
オフロード ターゲットによって提供される変数へのポインター。 この変数のサイズは sizeof(PNDIS_OFFLOAD_EVENT_HANDLERS) です。 NdisMGetOffloadHandlers 関数の呼び出しが成功した場合、関数は、この変数で、NDIS_OFFLOAD_EVENT_HANDLERS構造体へのポインターを返します。 この構造体は、エントリ ポイントを含む、チムニー固有の構造のヘッダーとして機能します。 NDIS_OFFLOAD_EVENT_HANDLERS構造体は、次のように書式設定されます。
typedef struct _NDIS_OFFLOAD_EVENT_HANDLERS {
NDIS_OBJECT_HEADER Header;
} NDIS_OFFLOAD_EVENT_HANDLERS, *PNDIS_OFFLOAD_EVENT_HANDLERS;
この構造体には、次のメンバーが含まれています。
ヘッダ
NDIS オブジェクト ヘッダーを指定します。これは、NDIS_OBJECT_HEADER 構造体として書式設定されます。
戻り値
NdisMGetOffloadHandlers は、次のいずれかを返すことができます。
| リターン コード | 形容 |
|---|---|
|
呼び出しは成功しました。 返された NDIS エントリ ポイントは、指定されたチムニーの種類に対して有効です。 |
|
NDIS は、オフロード ターゲットで指定されたチムニーの種類をサポートしていません。 この場合、NDIS は、有効な OffloadHandlers ポインターを返しません。 |
備考
オフロード ターゲットは、その ミニポートInitializeEx 関数からこの関数を呼び出して、特定のチムニー型の NDIS 関数のエントリ ポイントを取得します。 オフロード ターゲットは、NdisMGetOffloadHandlers をサポートする各チムニーの種類に対して 1 回 呼び出します。 各呼び出しで、オフロード ターゲットは異なるチムニーの種類を指定します。
NdisMGetOffloadHandlers 関数の呼び出しが成功した場合、NDIS は有効な OffloadHandlers ポインターを提供します。これは、NDIS_OFFLOAD_EVENT_HANDLERS構造体を指します。 この構造体には、NDIS_OBJECT_HEADER 構造体が含まれています。 オフロード ターゲットは、NDIS_OBJECT_HEADER構造体の 型の、リビジョン、および Size メンバーを調べます。 これらのメンバーは、チムニー固有のエントリ ポイントを含む構造体、この構造体のリビジョン番号、およびこの構造体のサイズをバイト単位で指定します。 Type 値は、の パラメーターに指定されたオフロード ターゲットと同じ値です。
オフロード ターゲットが指定した リビジョン 番号をサポートしている場合、OffloadHandlers ポインターを適切なチムニー固有の構造体型へのポインターにキャストします。 次の表は、各チムニータイプのチムニー固有の構造を示しています。
| ・チムニータイプ | チムニー固有のハンドラー構造 |
|---|---|
| NdisTcpChimneyOffload の | NDIS_TCP_OFFLOAD_EVENT_HANDLERS |
たとえば、NdisTcpChimneyOffload チムニー 型の場合、オフロード ターゲットは OffloadHandlers ポインターを *PNDIS_TCP_OFFLOAD_EVENT_HANDLERS にキャストします。
チムニー固有のハンドラー構造には、NDIS_OFFLOAD_EVENT_HANDLERS構造と同じNDIS_OBJECT_HEADER構造が含まれています。
オフロード ターゲットは、チムニー固有の構造体から独自の内部データ構造にエントリ ポイントをコピーし、返します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | ndischimney.h (Ndischimney.h を含む) |
関連項目
NDIS_TCP_OFFLOAD_EVENT_HANDLERSNdisMSetMiniportAttributes の