WdfChildListUpdateChildDescriptionAsMissing-Funktion (wdfchildlist.h)

Artikel
02/29/2024

[Gilt nur für KMDF]

Die WdfChildListUpdateChildDescriptionAsMissing-Methode informiert das Framework darüber, dass ein angegebenes untergeordnetes Gerät derzeit nicht angeschlossen ist oder anderweitig nicht verfügbar ist.

Syntax

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

Parameter

[in] ChildList

Ein Handle für ein untergeordnetes Listenobjekt.

[in] IdentificationDescription

Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER Struktur, die eine vom Treiber bereitgestellte untergeordnete Identifikationsbeschreibung identifiziert.

Rückgabewert

WdfChildListUpdateChildDescriptionAsMissing gibt STATUS_SUCCESS oder einen anderen status Wert zurück, für den NT_SUCCESS(status)true entspricht, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Ein Eingabeparameter war ungültig.
STATUS_INVALID_DEVICE_REQUEST	Die Größe der Struktur, auf die IdentificationDescription verweist, war falsch.
STATUS_NO_SUCH_DEVICE	Das angegebene Gerät wurde in der untergeordneten Liste nicht gefunden.

Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.

Eine Systemfehlerprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Ihr Treiber kann melden, dass ein Gerät nicht verfügbar ist, auch wenn der Treiber nie WdfChildListAddOrUpdateChildDescriptionAsPresent aufgerufen hat, um zu melden, dass das Gerät vorhanden war. In diesem Fall gibt die WdfChildListUpdateChildDescriptionAsMissing-Methode nur STATUS_NO_SUCH_DEVICE zurück.

Wenn Sie melden möchten, dass alle Geräte in einer untergeordneten Liste nicht verfügbar sind, kann Ihr Treiber einfach WdfChildListBeginScan und sofort WdfChildListEndScan aufrufen, anstatt WdfChildListUpdateChildDescriptionAsMissing für jedes Gerät aufzurufen.

Weitere Informationen zu untergeordneten Geräten und untergeordneten Listen finden Sie unter Dynamische Enumeration.

Beispiele

Im folgenden Codebeispiel wird das Framework darüber informiert, dass ein untergeordnetes Gerät mit einer angegebenen Seriennummer nicht verfügbar ist.

PDO_IDENTIFICATION_DESCRIPTION  description;
NTSTATUS  status;

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

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

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
Kopfzeile	wdfchildlist.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent

Freigeben über