NdisFDirectOidRequest 函式 (ndis.h)

發行項
03/01/2024

篩選驅動程式會呼叫 NdisFDirectOidRequest 函式，將直接 OID 要求轉送至基礎驅動程式或產生這類要求。

語法

NDIS_STATUS NdisFDirectOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

參數

[in] NdisFilterHandle

識別篩選模組的 NDIS 句柄。 NDIS 在對 FilterAttach 函式的呼叫中，將句柄傳遞至篩選驅動程式。

[in] OidRequest

NDIS_OID_REQUEST 結構的指標，指定使用指定之 OID_Xxx 程式代碼要求的作業。結構可以指定 OID 查詢、設定或方法要求。

傳回值

如需可能的傳回值清單，請參閱 NdisDirectOidRequest 函式。

備註

NdisFDirectOidRequest 函式無法用於一般 OID 要求。針對一般 OID 要求，請改用 NdisFOidRequest 函式。 NdisFDirectOidRequest 只能用於 NDIS 支援的 OID，以便與直接 OID 介面搭配使用。例如，可以使用下列 OID：

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA

篩選驅動程式可以呼叫 NdisFDirectOidRequest，將 OID 要求導向至基礎驅動程式。

篩選驅動程式也可以篩選源自於過度驅動程式的直接 OID 要求。 NDIS 會呼叫 FilterDirectOidRequest 函式來處理每個這類要求。

如果 NdisFDirectOidRequest 傳回NDIS_STATUS_PENDING，NDIS 會在基礎驅動程式完成 OID 要求之後呼叫 FilterDirectOidRequestComplete 函式。呼叫 NdisFDirectOidRequest 的驅動程序必須註冊 FilterDirectOidRequestComplete 函式 。

當驅動程式處於重新啟動、執行中、暫停或暫停狀態時，可以呼叫 NdisFDirectOidRequest。

直接 OID 要求介面類似於一般 OID 要求介面。如需發出一般要求的詳細資訊，請參閱 NdisFOidRequest。

規格需求

需求	值
最低支援的用戶端	NDIS 6.1 和更新版本支援。
目標平台	桌面
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL