共用方式為


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);

規格需求

需求
目標平台 Universal
最低 KMDF 版本 1.0
標頭 wdfcontrol.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL PASSIVE_LEVEL
DDI 合規性規則 ControlDeviceInitAPI (kmdf) CtlDeviceFinishInitDeviceAdd (kmdf) CtlDeviceFinishInitDrEntry (kmdf ) , DoubleDeviceInitFree (kmdf) DriverCreate (kmdf) InitFreeDeviceCCallback (kmdf) InitFreeDeviceCreate (kmdf) InitFreeDeviceCreateType2 (kmdf) InitFreeDeviceCreateType4 (kmdf ) 、 KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf)

另請參閱

WDFDEVICE_INIT

WDF_OBJECT_ATTRIBUTES_INIT

WdfControlDeviceInitSetShutdownNotification

WdfControlFinishInitializing

WdfDeviceCreate

WdfDeviceInitAssignName

WdfDeviceInitAssignSDDLString