Функция WdfDeviceInitAssignName (wdfdevice.h)

Статья
07/16/2024

[Применимо только к 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 назначить имя, драйвер впоследствии может вызывать WdfDeviceInitAssignName с параметром NULLDeviceName, чтобы очистить имя устройства. Если имя устройства равно null, а объекту устройства требуется имя (так как оно представляет PDO или устройство управления), операционная система создаст имя.

Дополнительные сведения об именовании объектов устройств см. в статье Управление доступом к устройству в Framework-Based драйверах.

Дополнительные сведения о вызове WdfDeviceCreateсм. в создании объекта устройства Framework.

Примеры

В следующем примере кода на устройстве назначается имя устройства NT.

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
заголовка	wdfdevice.h (include Wdf.h)
библиотеки	Wdf01000.sys (см. управление версиями библиотеки Платформы).)
IRQL	PASSIVE_LEVEL
правил соответствия DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), драйвер Create(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNu, KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoD, PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf)

См. также

WdfDeviceRetrieveDeviceName

Поделиться через