Metode IPnpCallback::OnD0Entry (wudfddi.h)

Artikel
02/27/2024

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode OnD0Entry memberi tahu driver ketika perangkat memasuki status daya D0 sehingga driver dapat melakukan operasi yang diperlukan, seperti mengaktifkan perangkat.

Sintaks

HRESULT OnD0Entry(
  [in] IWDFDevice             *pWdfDevice,
  [in] WDF_POWER_DEVICE_STATE previousState
);

Parameter

[in] pWdfDevice

Penunjuk ke antarmuka IWDFDevice untuk objek perangkat perangkat yang memasuki status daya D0.

[in] previousState

Nilai jenis WDF_POWER_DEVICE_STATE yang mengidentifikasi status daya perangkat sebelum memasuki status daya D0.

Mengembalikan nilai

Jika panggilan balik OnD0Entry tidak mengalami kesalahan, panggilan balik tersebut harus mengembalikan S_OK atau kode status lain yang SUCCEEDED(statusnya) sama dengan TRUE.

Jika mengembalikan kode status yang SUCCEEDED(statusnya) sama dengan FALSE, kerangka kerja akan menghapus perangkat. Jika driver perangkat tidak mendukung perangkat lain pada sistem, manajer I/O akan membongkar driver. Kerangka kerja memberi tahu manajer PnP, yang kemudian mencoba menghidupkan ulang perangkat dengan meminta driver bus untuk menghitung ulang perangkatnya. Jika driver Anda dibongkar, driver akan dimuat ulang. Dalam hal ini, kerangka kerja tidak akan memanggil fungsi panggilan balik IPnpCallback::OnD0Exit driver.

Kode kesalahan HRESULT didefinisikan dalam Winerror.h.