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