Funzione WdfChildListUpdateChildDescriptionAsMissing (wdfchildlist.h)

Articolo
08/08/2023

[Si applica solo a KMDF]

Il metodo WdfChildListUpdateChildDescriptionAsMissing informa il framework che un dispositivo figlio specificato è attualmente scollegato o altrimenti non disponibile.

Sintassi

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

Parametri

[in] ChildList

Handle per un oggetto elenco figlio.

[in] IdentificationDescription

Puntatore a una struttura di WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER allocata dal chiamante che identifica una descrizione di identificazione figlio fornita dal driver.

Valore restituito

WdfChildListUpdateChildDescriptionAsMissing restituisce STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(status) è TRUE, se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Parametro di input non valido.
STATUS_INVALID_DEVICE_REQUEST	La dimensione della struttura a cui punta IdentificationDescription non è corretta.
STATUS_NO_SUCH_DEVICE	Il dispositivo specificato non è stato trovato nell'elenco figlio.

Questo metodo potrebbe anche restituire altri valori NTSTATUS.

Un controllo dei bug di sistema si verifica se il driver fornisce un handle di oggetto non valido.

Commenti

Il driver può segnalare che un dispositivo non è disponibile anche se il driver non ha mai chiamato WdfChildListAddOrUpdateChildDescriptionAsPresent per segnalare che il dispositivo era presente. In questo caso, il metodo WdfChildListUpdateChildDescriptionAsMissing restituisce solo STATUS_NO_SUCH_DEVICE.

Se si vuole segnalare che tutti i dispositivi in un elenco figlio non sono disponibili, il driver può semplicemente chiamare WdfChildListBeginScan, seguito immediatamente da WdfChildListEndScan, anziché chiamare WdfChildListUpdateChildDescriptionAsMissing per ogni dispositivo.

Per altre informazioni sui dispositivi figlio e sugli elenchi figlio, vedere Enumerazione dinamica.

Esempio

Nell'esempio di codice seguente viene indicato al framework che un dispositivo figlio con un numero di serie specificato non è disponibile.

PDO_IDENTIFICATION_DESCRIPTION  description;
NTSTATUS  status;

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

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfchildlist.h (include Wdf.h)
Libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent