spbDeviceInitConfig 函数 (spbcx.h)

项目
02/26/2024

SpbDeviceInitConfig 方法将 SPB 框架扩展 (SpbCx) 附加到要创建的 WDFDEVICE (FDO 或 PDO) 对象的 I/O 请求链。

语法

NTSTATUS SpbDeviceInitConfig(
  [in, out] WDFDEVICE_INIT *DeviceInit
);

参数

[in, out] DeviceInit

指向要配置的 WDFDEVICE_INIT 结构的指针。

返回值

如果调用成功，SpbDeviceInitConfig 将返回STATUS_SUCCESS。可能的返回值包括以下错误代码。

返回代码	说明
STATUS_INSUFFICIENT_RESOURCES	无法分配所需的系统资源。

注解

此方法将 SpbCx 的配置信息与要创建的设备对象的 WDFDEVICE_INIT 结构相关联， (PDO 或 FDO) 。驱动程序的 EvtDriverDeviceAdd 回调例程应先调用 SpbDeviceInitConfig ，然后再调用 WdfDeviceCreate 方法来创建设备对象。

示例

下面的代码示例演示如何使用 SpbDeviceInitConfig 方法将 SpbCx 框架扩展的配置信息与 WDFDEVICE_INIT 结构相关联。

//
// FxDeviceInit is a pointer to a WDFDEVICE_INIT structure that comes as a
// parameter for an EvtDriverDeviceAdd handler, or from WdfPdoInitAllocate.
//

status = SpbDeviceInitConfig(FxDeviceInit);

if (!NT_SUCCESS(status))
{
    return status;
}

// 
// Set WDF and SpbCx device-level configuration options.
//

...

//
// Call WdfDeviceCreate
//

status = WdfDeviceCreate(&FxDeviceInit,...);