Funzione WdfChildListUpdateChildDescriptionAsMissing (wdfchildlist.h)

Articolo
02/07/2025

[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) è uguale a 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 IdentificationDescription punta non è corretta.
STATUS_NO_SUCH_DEVICE	Il dispositivo specificato non è stato trovato nell'elenco figlio.

Questo metodo può anche restituire altri valori NTSTATUS .

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

Osservazioni

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, invece di chiamare WdfChildListUpdateChildDescriptionAsMissing per ogni dispositivo.

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

Esempi

L'esempio di codice seguente informa il 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
                                                     );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	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)

Vedere anche

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent

Condividi tramite