共用方式為

IF_QUERY_OBJECT回呼函式 (ndis.h)

  • 發行項

ProviderQueryObject 函式會擷取網路介面的相關信息。

語法

IF_QUERY_OBJECT IfQueryObject;

NDIS_STATUS() IfQueryObject(
  [in]      NDIS_HANDLE ProviderIfContext,
  [in]      NET_IF_OBJECT_ID ObjectId,
  [in, out] PULONG pOutputBufferLength,
  [out]     PVOID pOutputBuffer
)
{...}

參數

[in] ProviderIfContext

識別介面提供者內容區域的句柄。 介面提供者在呼叫 中將此句柄傳遞至 NDIS NdisIfRegisterInterface 函式。

[in] ObjectId

物件標識符，該對像是查詢要求的目標。 如需套用至介面提供者 (OID) 的物件識別符清單，請參閱 NDIS 網路介面 OID。

[in, out] pOutputBufferLength

NDIS 提供的變數指標，其中 NDIS 會提供輸出緩衝區的長度。 ProviderQueryObject 會寫入它放入輸出緩衝區的數據長度。

[out] pOutputBuffer

NDIS 提供的輸出緩衝區指標， 其中 ProviderQueryObject 會將回應寫入查詢要求。

傳回值

ProviderQueryObject 會傳回下列其中一個狀態值：

傳回碼 Description
NDIS_STATUS_SUCCESS
 作業已成功完成。
NDIS_STATUS_RESOURCES
 作業失敗，因為資源不足。
NDIS_STATUS_INVALID_PARAMETER
 呼叫失敗，因為某些輸入參數無效。
NDIS_STATUS_Xxx
 呼叫因其他原因而失敗。 此函式可以從呼叫的函式傳播錯誤碼，或產生適當的錯誤碼。

備註

NDIS 會呼叫網路介面提供者的 ProviderQueryObject 函式，以取得提供者所註冊之介面的相關信息。 如需適用於介面提供者的 OID 清單，請參閱 NDIS 網路介面 OID。

NDIS 會在 IRQL = PASSIVE_LEVEL呼叫 ProviderQueryObject 。

規格需求

需求 值
最低支援的用戶端 NDIS 6.0 和更新版本支援。
目標平台 Windows
標頭 ndis.h (包含 Ndis.h)
IRQL PASSIVE_LEVEL

另請參閱

NdisIfRegisterInterface