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 時發生。

規格需求

   
目標平台 Universal
最小 KMDF 版本 1.27
標頭 netadapter.h (包括 netadaptercx.h)
程式庫 NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL