Fungsi WdfChildListUpdateChildDescriptionAsMissing (wdfchildlist.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Metode WdfChildListUpdateChildDescriptionAsMissing menginformasikan kerangka kerja bahwa perangkat anak tertentu saat ini dilepas atau tidak tersedia.

Sintaks

NTSTATUS WdfChildListUpdateChildDescriptionAsMissing(
  [in] WDFCHILDLIST                                 ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

Parameter

[in] ChildList

Handel ke objek daftar anak.

[in] IdentificationDescription

Penunjuk ke struktur WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER yang dialokasikan penelepon yang mengidentifikasi deskripsi identifikasi anak yang disediakan driver.

Nilai kembali

WdfChildListUpdateChildDescriptionAsMissing mengembalikan STATUS_SUCCESS, atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE, jika operasi berhasil. Jika tidak, metode ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_INVALID_PARAMETER
 Parameter input tidak valid.
STATUS_INVALID_DEVICE_REQUEST
 Ukuran struktur yang ditunjukkan IdentificationDescription salah.
STATUS_NO_SUCH_DEVICE
 Perangkat yang ditentukan tidak ditemukan di daftar anak.
 

Metode ini mungkin juga mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug sistem terjadi jika driver memasok handel objek yang tidak valid.

Keterangan

Driver Anda dapat melaporkan bahwa perangkat tidak tersedia meskipun driver tidak pernah disebut WdfChildListAddOrUpdateChildDescriptionAsPresent untuk melaporkan bahwa perangkat tersebut ada. Dalam hal ini, metode WdfChildListUpdateChildDescriptionAsMissing hanya mengembalikan STATUS_NO_SUCH_DEVICE.

Jika Anda ingin melaporkan bahwa semua perangkat dalam daftar anak tidak tersedia, driver Anda cukup memanggil WdfChildListBeginScan, diikuti segera oleh WdfChildListEndScan, alih-alih memanggil WdfChildListUpdateChildDescriptionAsMissing untuk setiap perangkat.

Untuk informasi selengkapnya tentang perangkat anak dan daftar anak, lihat Enumerasi Dinamis.

Contoh

Contoh kode berikut menginformasikan kerangka kerja bahwa perangkat anak dengan nomor seri tertentu tidak tersedia.

PDO_IDENTIFICATION_DESCRIPTION  description;
NTSTATUS  status;

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(
                                                 &description.Header,
                                                 sizeof(description)
                                                 );

description.SerialNo = SerialNo;
status = WdfChildListUpdateChildDescriptionAsMissing(
                                                     list,
                                                     &description.Header
                                                     );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdfchildlist.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent