WdfControlDeviceInitAllocate 函数 （wdfcontrol.h）
[仅适用于 KMDF]
WdfControlDeviceInitAllocate 方法分配驱动程序创建新控件设备对象时使用的 WDFDEVICE_INIT 结构。
语法
PWDFDEVICE_INIT WdfControlDeviceInitAllocate(
[in] WDFDRIVER Driver,
[in] const UNICODE_STRING *SDDLString
);
参数
[in] Driver
框架驱动程序对象的句柄。
[in] SDDLString
指向描述 Unicode 字符串的 UNICODE_STRING 结构的指针。 此字符串是安全描述符的安全描述符定义语言（SDDL）表示形式。 有关详细信息，请参阅以下“备注”部分。
返回值
WdfControlDeviceInitAllocate 返回指向框架分配 WDFDEVICE_INIT 结构的指针（如果作成功）。 否则，该方法将返回 NULL 。
言论
如果希望驱动程序创建控制设备对象，驱动程序必须调用 WdfControlDeviceInitAllocate 以获取可传递给 WdfDeviceCreate的WDFDEVICE_INIT结构。
驱动程序可以使用 SDDL 的子集来指定安全设置。 Wdmsec.h 文件定义了一组SDDL_DEVOBJ_Xxx格式的常量，可以使用这些常量。 有关安全描述符和 SDDL 的详细信息，请参阅 保护设备对象。
WdfDeviceInitAssignSDDLString 方法覆盖安全设置（如果有）WdfControlDeviceInitAllocate。
有关调用 WdfControlDeviceInitAllocate的详细信息，请参阅 使用控制设备对象。
例子
下面的代码示例分配DEVICE_INIT结构、分配设备对象名称、注册关闭通知回调函数并创建控制设备对象。 有关使用 WdfControlDeviceInitAllocate的更复杂的示例，请参阅 NONPNP 示例驱动程序或 NDISProt 示例驱动程序。
PWDFDEVICE_INIT deviceInit = NULL;
NTSTATUS status;
WDF_OBJECT_ATTRIBUTES objectAttribs;
deviceInit = WdfControlDeviceInitAllocate(
hDriver,
&SDDL_DEVOBJ_SYS_ALL_ADM_RWX_WORLD_RW_RES_R
);
if (deviceInit == NULL) {
status = STATUS_INSUFFICIENT_RESOURCES;
goto Error;
}
status = WdfDeviceInitAssignName(
deviceInit,
&ntDeviceName
);
if (!NT_SUCCESS(status)) {
WdfDeviceInitFree(deviceInit);
deviceInit = NULL;
goto Error;
}
WdfControlDeviceInitSetShutdownNotification(
deviceInit,
EvtShutdownNotification,
WdfDeviceShutdown
);
WDF_OBJECT_ATTRIBUTES_INIT(&objectAttribs);
status = WdfDeviceCreate(
&deviceInit,
&objectAttribs,
&controlDevice
);
if (!NT_SUCCESS(status)) {
WdfDeviceInitFree(deviceInit);
deviceInit = NULL;
goto Error;
}
WdfControlFinishInitializing(controlDevice);
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 标头 | wdfcontrol.h （包括 Wdf.h） |
| 库 | Wdf01000.sys（请参阅框架库版本控制。 |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | ControlDeviceInitAPI（kmdf），CtlDeviceFinishInitDeviceAdd（kmdf），CtlDeviceFinishInitDrEntry（kmdf）， DoubleDeviceInitFree（kmdf）， DriverCreate（kmdf）， InitFreeDeviceCallback（kmdf） kmdf），InitFreeDeviceCreate（kmdf），InitFreeDeviceCreateType2（kmdf），InitFreeDeviceCreateType4（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |