次の方法で共有

NdisMRegisterWdiMiniportDriver 関数 (dot11wdi.h)

  • [アーティクル]

大事な

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

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

構文

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 パラメーターは、ミニポートDriverCharacteristics の構造体の MajorNdisVersion メンバーで指定されている NDIS バージョン 正しくありません。
NDIS_STATUS_BAD_VERSION
 特性構造で指定された MajorNdisVersion または minorNdisVersion が無効です。
NDIS_STATUS_RESOURCES
 リソースの不足 (場合によってはメモリ) により、NDIS が呼び出し元を登録できなくなります。
NDIS_STATUS_FAILURE
 これは既定のエラー状態であり、上記のエラーのいずれも登録が失敗しなかった場合に返されます。
その他のNDIS_STATUS コード
 エラーが発生した場合の適切なNDIS_STATUS コード。

必要条件

要件 価値
サポートされる最小クライアント Windows 10
サポートされる最小サーバー Windows Server 2016
ターゲット プラットフォーム の ウィンドウズ
ヘッダー dot11wdi.h
ライブラリ Ndis.lib
IRQL PASSIVE_LEVEL

関連項目

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS