次の方法で共有

NdisIfFreeNetLuidIndex 関数 (ndis.h)

  • [アーティクル]

NdisIfFreeNetLuidIndex 関数は、以前に呼び出しによって割り当てられたネットワーク インターフェイス NET_LUID インデックスを解放します。NdisIfAllocateNetLuidIndex 関数を します。

構文

NDIS_STATUS NdisIfFreeNetLuidIndex(
       NET_IFTYPE ifType,
  [in] UINT32     NetLuidIndex
);

パラメーター

ifType

インデックスが割り当てられたインターフェイスの種類。 呼び出し元は、NdisIfAllocateNetLuidIndexを使用してNET_LUIDインデックスを割り当てるときに使用したのと同じ値を指定する必要があります。 インターフェイスの種類の一覧については、「NDIS インターフェイスの種類を参照してください。

[in] NetLuidIndex

NDIS が解放する必要があるNET_LUIDインデックス値。 このインデックスは、NdisIfAllocateNetLuidIndex 以前の呼び出しで割り当てられました。

戻り値

NdisIfFreeNetLuidIndex は、次のいずれかの値を返します。

リターン コード 形容
NDIS_STATUS_SUCCESS
 操作が正常に完了しました。
DIS_STATUS_INVALID_PARAMETER
 NdisIfFreeNetLuidIndexNetLuidIndex パラメーターで、IfType パラメーターが指定した型に割り当てられなかったインデックス 指定したため、失敗しました。
 

NdisIfFreeNetLuidIndex の呼び出しが失敗した場合、インターフェイス プロバイダーは、インデックスに関連する永続ストレージに保存された情報をすべて削除する必要があります。 情報を削除すると、プロバイダーは、コンピューターの再起動後に既に解放されているインデックスを解放しようとし続けなくなります。

備考

NDIS インターフェイス プロバイダーは、NdisIfFreeNetLuidIndex 関数を呼び出して、NET_LUID インデックスを解放します。 インターフェイス プロバイダーは、インターフェイスがローカル コンピューターで使用されなくなった場合にのみ、NET_LUID インデックスを解放する必要があります。

NdisIfFreeNetLuidIndex は、以前に割り当てられたNET_LUIDインデックスを NDIS に返し、別のインターフェイスに再割り当てできます。 呼び出し元は、IfType で呼び出したときに使用したのと同じインターフェイス型を渡す必要があります。NdisIfAllocateNetLuidIndex 関数を して、NET_LUID インデックスを割り当てます。

プロバイダーは、解放されたNET_LUIDインデックスまたは関連付けられているNET_LUID値を、NdisIfFreeNetLuidIndex 呼び出した後、他の NDIS 関数呼び出しで使用しないでください。

必要条件

要件 価値
サポートされる最小クライアント NDIS 6.0 以降でサポートされています。
ターゲット プラットフォーム の デスクトップ
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 を する Irql_Interfaces_Function(ndis)

関連項目

NET_LUID

NdisIfAllocateNetLuidIndex の