共用方式為

NdisAllocateCloneOidRequest 函式 (ndis.h)

  • 發行項

NdisAllocateCloneOidRequest 函式會為新的NDIS_OID_REQUEST結構配置記憶體，並將現有NDIS_OID_REQUEST結構中的所有資訊複製到新配置的結構。

語法

NDIS_STATUS NdisAllocateCloneOidRequest(
  [in] IN NDIS_HANDLE        SourceHandle,
       IN PNDIS_OID_REQUEST  OidRequest,
  [in] IN UINT               PoolTag,
       OUT PNDIS_OID_REQUEST *ClonedOidRequest
);

參數

[in] SourceHandle

識別篩選模組或中繼驅動程式通訊協議系結的 NDIS 句柄。

OidRequest

NDIS 從中將資訊複製到新配置結構的現有 NDIS_OID_REQUEST 結構指標。

[in] PoolTag

核心集區標籤。 標籤是以單引號分隔的字串，通常以反向順序指定四個字元。

ClonedOidRequest

NDIS_OID_REQUEST 結構的指標。 如果 NDIS 傳回NDIS_STATUS_SUCCESS，NDIS 會提供新、複製NDIS_OID_REQUEST結構的指標;否則，NDIS 會將指標值設定為 NULL。

傳回值

NdisAllocateClonedRequest 可以傳回下列其中一個狀態值：

傳回碼 Description
NDIS_STATUS_SUCCESS
 NDIS 已成功配置NDIS_OID_REQUEST結構。 CloneRequest 參數包含NDIS_OID_REQUEST結構的指標。
NDIS_STATUS_INVALID_PARAMETER
 配置要求失敗，因為 SourceHandle 中指定的 NDIS 句柄無效。
NDIS_STATUS_RESOURCES
 配置要求失敗，因為 NDIS 沒有足夠的資源來完成配置要求。
NDIS_STATUS_FAILURE
 驅動程式因為上述清單中以外的原因而無法配置複製的結構。

備註

若要將要求轉送至基礎驅動程式，NDIS 中繼驅動程式或篩選驅動程式必須呼叫 NdisAllocateCloneOidRequest 來配置複製 NDIS_OID_REQUEST 結構。 篩選驅動程式或中繼驅動程式不應該將原始NDIS_OID_REQUEST結構轉送至基礎驅動程式。

NdisAllocateCloneOidRequest 會配置新的記憶體，並將數據從現有的NDIS_OID_REQUEST結構複製到新的結構。

驅動程式後續必須呼叫 NdisFreeCloneOidRequest 函式，以釋放NDIS_OID_REQUEST結構。

規格需求

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

另請參閱

NDIS_OID_REQUEST

NdisFreeCloneOidRequest