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
物件標識符,該對像是集合要求的目標。 如需套用至介面提供者的物件識別碼清單,請參閱 NDIS 網路介面 OIDs。
[in] InputBufferLength
pInputBuffer 指向的緩衝區長度,以位元組為單位。
[in] pInputBuffer
輸入緩衝區的指標,指定介面提供者應該用來設定對象數據的資訊。
傳回值
ProviderSetObject 會傳回下列其中一個狀態值:
傳回碼 | 描述 |
---|---|
|
作業已順利完成。 |
|
作業失敗,因為資源不足。 |
|
呼叫失敗,因為某些輸入參數無效。 |
|
呼叫因其他原因而失敗。 此函式可以從呼叫或產生適當錯誤碼的函式傳播錯誤碼。 |
言論
NDIS 會呼叫網路介面提供者的 ProviderSetObject 函式,以設定與提供者註冊之介面相關聯的資訊。 如需適用於介面提供者的 OID 清單,請參閱 NDIS 網路介面 OID。
請注意,目前未定義任何設定的 OID。
NDIS 會在 IRQL = PASSIVE_LEVEL 呼叫 ProviderSetObject。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平臺 | 窗戶 |
標頭 | ndis.h (包括 Ndis.h) |
IRQL | PASSIVE_LEVEL |