Fungsi WdfDeviceInitAssignName (wdfdevice.h)

Artikel
07/16/2024

[Hanya berlaku untuk KMDF]

Metode WdfDeviceInitAssignName menetapkan nama perangkat ke objek perangkat perangkat.

Sintaksis

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

Parameter

[in] DeviceInit

Penunjuk ke struktur WDFDEVICE_INIT.

[in, optional] DeviceName

Penunjuk ke struktur UNICODE_STRING yang mewakili nama perangkat.

Mengembalikan nilai

Jika WdfDeviceInitAssignName tidak mengalami kesalahan yang dikembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:

Mengembalikan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	Sistem tidak dapat mengalokasikan ruang untuk menyimpan nama perangkat.

Komentar

Jika driver memanggil WdfDeviceInitAssignName, driver harus melakukannya sebelum memanggil WdfDeviceCreate.

Jika driver memanggil WdfDeviceInitAssignName untuk menetapkan nama, driver kemudian dapat memanggil WdfDeviceInitAssignName dengan parameter NULLDeviceName untuk menghapus nama perangkat. Jika nama perangkat NULL dan objek perangkat memerlukan nama (karena mewakili PDO atau perangkat kontrol ), sistem operasi akan membuat nama.

Untuk informasi selengkapnya tentang penamaan objek perangkat, lihat Mengontrol Akses Perangkat di Driver Framework-Based.

Untuk informasi selengkapnya tentang memanggil WdfDeviceBuat, lihat Membuat Objek Perangkat Kerangka Kerja.

Contoh

Contoh kode berikut menetapkan nama perangkat NT ke perangkat.

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

Persyaratan

Syarat	Nilai
Platform Target	Universal
versi KMDF Minimum	1.0
Header	wdfdevice.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	PASSIVE_LEVEL
aturan kepatuhan DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf)

Lihat juga

WdfDeviceRetrieveDeviceName

Bagikan melalui