NdisMRegisterWdiMiniportDriver 関数 (dot11wdi.h)

  • [アーティクル]

重要

このトピックは、Windows 10でリリースされた WDI ドライバー モデルの一部です。 WDI ドライバー モデルはメンテナンス モードであり、優先度の高い修正プログラムのみを受け取ります。 WiFiCx は、Windows 11でリリースされた Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。

ミニポート ドライバーは、NdisMRegisterWdiMiniportDriver 関数を呼び出して、初期化の最初の手順として NDIS に MiniportWdiXxx エントリ ポイントを登録します。

構文

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisMRegisterWdiMiniportDriver(
  [in]           DRIVER_OBJECT                            *DriverObject,
  [in]           PCUNICODE_STRING                         RegistryPath,
  [in, optional] NDIS_MINIPORT_DRIVER_CONTEXT             NdisDriverContext,
  [in]           NDIS_MINIPORT_DRIVER_CHARACTERISTICS     *MiniportDriverCharacteristics,
  [in]           NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS *MiniportWdiCharacteristics,
  [out]          NDIS_MINIPORT_DRIVER_HANDLE              *NdisMiniportDriverHandle
);

パラメーター

[in] DriverObject

ミニポート ドライバーが Argument1 パラメーターで DriverEntry ルーチンで受け取った不透明なドライバー オブジェクトへのポインター (「NDIS ミニポート ドライバーの DriverEntry」を参照)。

[in] RegistryPath

ミニポート ドライバーが Argument2 パラメーターで DriverEntry ルーチンで受け取った不透明なレジストリ パスへのポインター。

[in, optional] NdisDriverContext

ドライバーが状態と構成情報を保持する、ドライバーによって割り当てられたコンテキスト領域へのハンドル。

[in] MiniportDriverCharacteristics

へのポインター 呼び 出し元が初期化した構造体をNDIS_MINIPORT_DRIVER_CHARACTERISTICSします。

[in] MiniportWdiCharacteristics

呼び出し元が初期化 したNDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS 構造体へのポインター。

[out] NdisMiniportDriverHandle

呼び出し元が指定したハンドル変数へのポインター。 NDIS は、このドライバーを一意に識別するこの変数にハンドルを書き込みます。 ドライバーは、後続の NdisXxx 関数呼び出しで使用するために、このハンドルを保存する必要があります。

戻り値

NdisMRegisterWdiMiniportDriver は、次のいずれかの戻り値を返すことができます。

リターン コード 説明
NDIS_STATUS_SUCCESS
 NdisMRegisterWdiMiniportDriver が WDI ミニポート ドライバーを正常に登録しました。
NDIS_STATUS_BAD_CHARACTERISTICS
 CharacteristicsLength パラメーターは、MiniportDriverCharacteristics の構造体の MajorNdisVersion メンバーで指定されている NDIS バージョンでは正しくありません。
NDIS_STATUS_BAD_VERSION
 特性構造で指定された MajorNdisVersion または MinorNdisVersion が無効です。
NDIS_STATUS_RESOURCES
 リソース (メモリ) が不足しているため、NDIS が呼び出し元を登録できなくなります。
NDIS_STATUS_FAILURE
 これは既定のエラー状態であり、上記のエラーのいずれも登録に失敗しなかった場合に返されます。
その他のNDIS_STATUSコード
 エラーが発生した場合の適切なNDIS_STATUS コード。

要件

要件 値
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
ヘッダー dot11wdi.h
Library Ndis.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS