NdisRegisterDeviceEx 関数 (ndis.h)

[アーティクル]
08/07/2023

NdisRegisterDeviceEx 関数は、指定した属性に基づいてデバイスオブジェクトを作成します。

構文

NDIS_STATUS NdisRegisterDeviceEx(
  [in]  NDIS_HANDLE                    NdisHandle,
  [in]  PNDIS_DEVICE_OBJECT_ATTRIBUTES DeviceObjectAttributes,
  [out] PDEVICE_OBJECT                 *pDeviceObject,
  [out] PNDIS_HANDLE                   NdisDeviceHandle
);

パラメーター

[in] NdisHandle

ミニポートドライバーハンドルまたはフィルタードライバーハンドル呼び出し元がを呼び出すことによって取得します。 NdisMRegisterMiniportDriver 関数または NdisFRegisterFilterDriver 関数はそれぞれです。

[in] DeviceObjectAttributes

へのポインター NDIS_DEVICE_OBJECT_ATTRIBUTES 新しいデバイスの属性を含む構造体です。

[out] pDeviceObject

呼び出しが成功した場合に、新しく作成された DEVICE_OBJECT 構造体へのポインターを指すポインター。呼び出しが失敗した場合、 pDeviceObject は NULL を指すように設定されます。

[out] NdisDeviceHandle

呼び出し元が指定した変数へのポインター。この関数が成功すると、デバイスオブジェクトへのハンドルが返されます。このハンドルは、ドライバーが後で呼び出す NdisDeregisterDeviceEx 関数に必要なパラメーターです。

戻り値

NdisRegisterDeviceEx は 、次のいずれかの状態値を返します。

リターンコード	説明
NDIS_STATUS_SUCCESS	NdisRegisterDeviceEx がデバイスを正常に登録しました。
NDIS_STATUS_NOT_SUPPORTED	呼び出し元は NDIS ドライバーではありません。
NDIS_STATUS_XXX または NTSTATUS_XXX	ドライバーがデバイスを登録しようとしましたが失敗しました。通常、このようなエラー状態は NdisXxx 関数またはカーネルモードサポートルーチンから伝達されます。

注釈

ミニポートドライバーとフィルタードライバーは、 NdisRegisterDeviceEx を呼び出して仮想デバイスを登録できます。

メモNDIS ドライバーは、NdisRegisterDeviceEx が作成したDEVICE_OBJECT構造体の DeviceExtension メンバーを変更することはできません。

NDIS ドライバーがデバイスオブジェクト内のコンテキスト情報の領域を必要とする場合、ドライバーは内の ExtensionSize メンバーの 0 以外の値を渡すことができます。deviceObjectAttributes パラメーターで構造体をNDIS_DEVICE_OBJECT_ATTRIBUTESします。この場合、NDIS はドライバーの拡張機能を割り当て、ドライバーはを呼び出すことができます。拡張機能へのポインターを取得する NdisGetDeviceReservedExtension 関数。

デバイスが不要になったら、ドライバーは後で NdisDeregisterDeviceEx 関数を呼び出す必要があります。 NdisRegisterDeviceEx に拡張機能が割り当てられている場合、NdisDeregisterDeviceEx は拡張機能を解放します。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_Miscellaneous_Function(ndis)