FILTER_DIRECT_OID_REQUEST回呼函式 (ndis.h)

NDIS 會呼叫篩選驅動程式的 FilterDirectOidRequest 函式,以處理與指定篩選模組相關聯的直接 OID 要求。

注意 您必須使用 FILTER_DIRECT_OID_REQUEST 類型來宣告函式。 如需詳細資訊,請參閱下列範例一節。
 

語法

FILTER_DIRECT_OID_REQUEST FilterDirectOidRequest;

NDIS_STATUS FilterDirectOidRequest(
  [in] NDIS_HANDLE FilterModuleContext,
  [in] PNDIS_OID_REQUEST OidRequest
)
{...}

參數

[in] FilterModuleContext

此要求目標之篩選模組的內容區域控制碼。 篩選驅動程式已在 FilterAttach 函式中建立並初始化此內容區域。

[in] OidRequest

指定所要求作業之 NDIS_OID_REQUEST 結構的指標,包括 OID_ Xx 程式碼。 結構可以指定查詢要求或設定要求

傳回值

FilterDirectOidRequest 會傳回下列其中一個狀態值:

傳回碼 描述
NDIS_STATUS_SUCCESS
FilterDirectOidRequest 已成功完成篩選驅動程式的查詢或設定此篩選模組的作業。
NDIS_STATUS_PENDING
篩選驅動程式會以非同步方式完成要求。 驅動程式完成要求之後,必須呼叫 NdisFDirectOidRequestComplete 函式,以通知 NDIS 要求已完成。
NDIS_STATUS_INVALID_OID
指定 OidRequest 的要求無效或無法辨識。
NDIS_STATUS_NOT_SUPPORTED
FilterDirectOidRequest 不支援 OID;OID 是選擇性的。
NDIS_STATUS_BUFFER_TOO_SHORT
OidRequest提供的緩衝區太小,無法保存要求的資料。
NDIS_STATUS_INVALID_LENGTH
針對查詢作業,NDIS_OID_REQUEST結構的InformationBufferLength成員不符合指定 OID 所需的長度。 FilterDirectOidRequest 傳回NDIS_OID_REQUEST結構之 BytesNeeded 成員中所需的緩衝區大小,以位元組為單位。
NDIS_STATUS_INVALID_DATA
針對設定作業,在 NDIS_OID_REQUEST指定 OID 的 InformationBuffer 成員中提供的資料無效。
NDIS_STATUS_NOT_ACCEPTED
FilterDirectOidRequest 嘗試收集要求的資訊,但失敗。
NDIS_STATUS_RESOURCES
FilterDirectOidRequest 因為資源不足而失敗。
NDIS_STATUS_FAILURE
適用 上述其中一個傳回值。 篩選驅動程式應該使用指定失敗原因的參數呼叫 NdisWriteErrorLogEntry 函式。

備註

FilterDirectOidRequest 是選擇性函式。 如果篩選驅動程式未使用直接的 OID 要求,它可以在呼叫NdisFRegisterFilterDriver函式時,將此函式的進入點設定為Null。 如果篩選驅動程式定義 ,則為 FilterDirectOidRequestComplete 函式必須提供 FilterDirectOidRequest 函式。

NDIS 會呼叫篩選驅動程式的 FilterDirectOidRequest 函式,以處理過度裝載驅動程式所產生之直接 OID 要求。 篩選驅動程式可以呼叫 NdisFDirectOidRequest 函式,將這類要求轉送至基礎驅動程式。 作為選項,篩選驅動程式也可以立即完成要求,而不需要轉送要求。

在驅動程式呼叫 NdisFDirectOidRequest之前,驅動程式必須配置 NDIS_OID_REQUEST 結構,並藉由呼叫 將要求資訊傳送至新結構 NdisAllocateCloneOidRequest 函式。

若要同步完成要求,篩選驅動程式會傳回NDIS_STATUS_SUCCESS或失敗狀態。 如果驅動程式傳回NDIS_STATUS_PENDING,則必須呼叫 NdisFDirectOidRequestComplete 函式,以通知 NDIS 要求已完成。

針對查詢作業, FilterDirectOidRequest 會傳回 InformationBuffer 成員中所要求的資訊,並將 NDIS_OID_REQUEST 結構之 BytesWritten 成員中的變數設定為其傳回的資訊量。 如果篩選驅動程式使用 NdisFDirectOidRequest傳遞要求,則基礎驅動程式會執行此動作。

針對設定作業 ,FilterDirectOidRequest 可以使用 NDIS_OID_REQUEST 結構 之 InformationBuffer 成員中的資料來設定指定 OID 所需的資訊。 在此情況下, FilterDirectOidRequest 會將 位於 BytesRead 的變數設定為所提供資料的數量。 如果篩選驅動程式使用NdisFDirectOidRequest傳遞要求,則基礎驅動程式會以這種方式設定BytesRead

NDIS 不會序列化它與其他 OID 要求一起傳送至 FilterDirectOidRequest 的要求。 當傳送至FilterOidRequest 或 FilterDirectOidRequest的其他要求未完成時,篩選驅動程式必須能夠處理對 FilterDirectOidRequest的多個呼叫。

NDIS 會在 IRQL < = DISPATCH_LEVEL呼叫FilterDirectOidRequest

例子

若要定義 FilterDirectOidRequest 函式,您必須先提供函式宣告,以識別您要定義的函式類型。 Windows 提供一組驅動程式的函式類型。 使用函式類型宣告函式有助於 驅動程式的程式碼分析靜態驅動程式驗證器 (SDV) ,以及其他驗證工具會尋找錯誤,而且這是撰寫 Windows 作業系統驅動程式的需求。

例如,若要定義名為 「 MyDirectOidRequest」 的 FilterDirectOidRequest 函式,請使用 FILTER_DIRECT_OID_REQUEST 類型,如下列程式碼範例所示:

FILTER_DIRECT_OID_REQUEST MyDirectOidRequest;

然後,實作您的函式,如下所示:

_Use_decl_annotations_
NDIS_STATUS
 MyDirectOidRequest(
    NDIS_HANDLE  FilterModuleContext,
    PNDIS_OID_REQUEST  OidRequest
    )
  {...}

FILTER_DIRECT_OID_REQUEST函式類型定義于 Ndis.h 標頭檔中。 若要在執行程式碼分析工具時更精確地識別錯誤,請務必將 Use_decl_annotations 注釋新增至函式定義。 Use_decl_annotations注釋可確保使用標頭檔中套用至FILTER_DIRECT_OID_REQUEST函式類型的批註。 如需函數宣告需求的詳細資訊,請參閱 使用 NDIS 驅動程式的函式角色類型來宣告函式。

如需 Use_decl_annotations的詳細資訊,請參閱 標注函式行為

規格需求

   
最低支援的用戶端 NDIS 6.1 和更新版本支援。
目標平臺 Windows
標頭 ndis.h (包括 Ndis.h)
IRQL <= DISPATCH_LEVEL

另請參閱

FilterAttach

FilterDirectOidRequestComplete

FilterOidRequest

NDIS_OID_REQUEST

NdisAllocateCloneOidRequest

NdisFDirectOidRequest

NdisFDirectOidRequestComplete

NdisWriteErrorLogEntry