Fungsi WdfDeviceInitAssignName (wdfdevice.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfDeviceInitAssignName menetapkan nama perangkat ke objek perangkat perangkat.

Sintaks

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.

Nilai kembali

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

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

Keterangan

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

Jika driver memanggil WdfDeviceInitAssignName untuk menetapkan nama, driver kemudian dapat memanggil WdfDeviceInitAssignName dengan parameter DeviceName NULL 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 WdfDeviceCreate, 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

Persyaratan Nilai
Target Platform 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