NdisFreeString 宏 (ndis.h)
NdisFreeString 函式會釋放由 NdisInitializeString 為緩衝字串配置的記憶體。
語法
void NdisFreeString(
[in] String
);
參數
[in] String
描述要釋放之字串的NDIS_STRING型別值。 針對 Windows 2000 和更新版本,NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。
傳回值
無
備註
NDIS 驅動程式通常會在初始化期間呼叫 NdisInitializeString 函式,例如,設定傳遞至 NdisXxx組態 函式的名稱。 針對驅動程式對 NdisInitializeString 進行的每個呼叫,驅動程式必須對 NdisFreeString 進行對應的呼叫。 釋放初始化期間配置的字串緩衝區時,驅動程式必須在驅動程式的初始化函式傳回控件之前呼叫 NdisFreeString 。
NdisFreeString 只能用於釋放以 NdisInitializeString 配置的緩衝區。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 支援 NDIS 6.0 和更新版本中的現有驅動程式,但新的驅動程式應該改用 RtlFreeAnsiString 或 RtlFreeUnicodeString。 |
目標平台 | 桌面 |
標頭 | ndis.h (包含 Ndis.h) |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | Irql_Miscellaneous_Function (ndis) |