共用方式為

NetAdapterCreate 函式 （netadapter.h）

  • 發行項

建立 NETADAPTER 物件。

語法

NTSTATUS NetAdapterCreate(
  [_In_]     NETADAPTER_INIT       *AdapterInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *AdapterAttributes,
  [_Out_]    NETADAPTER            *Adapter
);

參數

[_In_] AdapterInit

用戶端驅動程式先前從呼叫 NetAdapterInitAllocate收到的 NETADAPTER_INIT 結構的指標。

[_In_opt_] AdapterAttributes

呼叫端配置的 WDF_OBJECT_ATTRIBUTES 結構的指標。 結構的 ParentObject 必須 NULL。 參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。

[_Out_] Adapter

接收新 NETADAPTER 物件句柄之位置的指標。

傳回值

如果作業成功，函式會傳回STATUS_SUCCESS。 否則，此函式可能會傳回適當的NTSTATUS錯誤碼。

言論

呼叫 WdfDeviceCreate之後，用戶端通常會從其 EvtDriverDeviceAdd 例程內呼叫 NetAdapterCreate。

如需建立 NETADAPTER 的程式碼範例，請參閱 裝置初始化。

NETADAPTER 對像是標準 WDF 物件。 架構會管理其刪除作業，這會在刪除父 WDFDEVICE 時發生。

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.27
最低 UMDF 版本 2.33
標頭 netadapter.h （包括 netadaptercx.h）
連結庫 NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL