WdfChildListUpdateChildDescriptionAsMissing-Funktion (wdfchildlist.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

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

Syntax

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

Parameter

[in] ChildList

Ein Handle zu einem untergeordneten Listenobjekt.

[in] IdentificationDescription

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

Rückgabewert

WdfChildListUpdateChildDescriptionAsMissing gibt STATUS_SUCCESS oder einen anderen Statuswert 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-Wertezurückgeben.

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

Bemerkungen

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-aufrufen, gefolgt sofort von WdfChildListEndScan, 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-	Universal
Minimale KMDF-Version	1.0
Header-	wdfchildlist.h (include Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent

Freigeben über