IF_SET_OBJECT回呼函式 (ndis.h)
ProviderSetObject 函式會設定與網路介面相關聯的資訊。
語法
IF_SET_OBJECT IfSetObject;
NDIS_STATUS() IfSetObject(
[in] NDIS_HANDLE ProviderIfContext,
[in] NET_IF_OBJECT_ID ObjectId,
[in] ULONG InputBufferLength,
[in] PVOID pInputBuffer
)
{...}
參數
[in] ProviderIfContext
識別介面提供者內容區域的句柄。 介面提供者在呼叫 中將此句柄傳遞至 NDIS NdisIfRegisterInterface 函式。
[in] ObjectId
物件標識符,該對像是集合要求的目標。 如需套用至介面提供者 (OID) 的物件識別符清單,請參閱 NDIS 網路介面 OID。
[in] InputBufferLength
pInputBuffer 指向之緩衝區的長度,以位元組為單位。
[in] pInputBuffer
輸入緩衝區的指標,指定介面提供者應該用來設定對象數據的資訊。
傳回值
ProviderSetObject 會傳回下列其中一個狀態值:
傳回碼 | Description |
---|---|
|
作業已成功完成。 |
|
作業失敗,因為資源不足。 |
|
呼叫失敗,因為某些輸入參數無效。 |
|
呼叫因其他原因而失敗。 此函式可以從呼叫的函式傳播錯誤碼,或產生適當的錯誤碼。 |
備註
NDIS 會呼叫網路介面提供者的 ProviderSetObject 函式,以設定與提供者註冊之介面相關聯的資訊。 如需適用於介面提供者的 OID 清單,請參閱 NDIS 網路介面 OID。
請注意,目前未定義任何 OID。
NDIS 會在 IRQL = PASSIVE_LEVEL呼叫 ProviderSetObject 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平台 | Windows |
標頭 | ndis.h (包含 Ndis.h) |
IRQL | PASSIVE_LEVEL |