共用方式為

WdfDeviceInitAssignName 函式 （wdfdevice.h）

  • 發行項

[僅適用於 KMDF]

WdfDeviceInitAssignName 方法會將裝置名稱指派給裝置的裝置物件。

語法

NTSTATUS WdfDeviceInitAssignName(
  [in]           PWDFDEVICE_INIT  DeviceInit,
  [in, optional] PCUNICODE_STRING DeviceName
);

參數

[in] DeviceInit

WDFDEVICE_INIT 結構的指標。

[in, optional] DeviceName

代表裝置名稱之 UNICODE_STRING 結構的指標。

傳回值

如果 WdfDeviceInitAssignName 遇到任何錯誤，則不會傳回STATUS_SUCCESS。 其他傳回值包括：

傳回碼 描述
STATUS_INSUFFICIENT_RESOURCES
 系統無法配置空間來儲存裝置名稱。

言論

如果驅動程式呼叫 WdfDeviceInitAssignName，則必須先呼叫 WdfDeviceCreate。

如果驅動程式呼叫 WdfDeviceInitAssignName 來指派名稱，驅動程式接著可以使用 NULLDeviceName 參數呼叫 WdfDeviceInitAssignName，以清除裝置名稱。 如果裝置名稱 NULL，且裝置物件需要名稱（因為它代表 PDO 或 控制裝置），則操作系統會建立名稱。

如需命名裝置對象的詳細資訊，請參閱 Framework-Based 驅動程式中的 控制裝置存取。

如需呼叫 WdfDeviceCreate的詳細資訊，請參閱 建立 Framework Device Object。

例子

下列程式代碼範例會將 NT 裝置名稱指派給裝置。

DECLARE_CONST_UNICODE_STRING(MyDeviceName, L"\\Device\\Ramdisk") ;
status = WdfDeviceInitAssignName(
                                 DeviceInit,
                                 &MyDeviceName
                                 );
if (!NT_SUCCESS(status)) {
    return status;
}

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
標頭 wdfdevice.h （包括 Wdf.h）
連結庫 Wdf01000.sys （請參閱架構連結庫版本控制。）
IRQL PASSIVE_LEVEL
DDI 合規性規則 ChildDeviceInitAPI（kmdf），ControlDeviceInitAPI（kmdf），DeviceInitAPI（kmdf），DriverCreate （kmdf）， InitFreedeviceCallback（kmdf）， InitFreedeviceCreate（kmdf）， InitFreenull（kmdf） kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf），PdoDeviceInitAPI（kmdf）， PdoInitFreeDeviceCallback（kmdf）， PdoInitFreeDeviceCreate（kmdf）

另請參閱

WdfDeviceRetrieveDeviceName