Função WdfChildListUpdateChildDescriptionAsMissing (wdfchildlist.h)

Artigo
02/07/2025

[Aplica-se somente ao KMDF]

O método WdfChildListUpdateChildDescriptionAsMissing informa à estrutura que um dispositivo filho especificado está atualmente desconectado ou não está disponível.

Sintaxe

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

Parâmetros

[in] ChildList

Um identificador para um objeto de lista filho.

[in] IdentificationDescription

Um ponteiro para uma estrutura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER alocada pelo chamador que identifica uma descrição de identificação de filho fornecida pelo driver.

Valor de retorno

WdfChildListUpdateChildDescriptionAsMissing retorna STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a VERDADEIRO, se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um parâmetro de entrada era inválido.
STATUS_INVALID_DEVICE_REQUEST	O tamanho da estrutura à qual IdentificationDescription aponta estava incorreto.
STATUS_NO_SUCH_DEVICE	O dispositivo especificado não foi encontrado na lista filho.

Esse método também pode retornar outros valores NTSTATUS .

Uma verificação de bugs do sistema ocorre se o driver fornece um identificador de objeto inválido.

Observações

O driver pode relatar que um dispositivo não está disponível mesmo que o driver nunca tenha chamado WdfChildListAddOrUpdateChildDescriptionAsPresent para relatar que o dispositivo estava presente. Nesse caso, o método WdfChildListUpdateChildDescriptionAsMissing apenas retorna STATUS_NO_SUCH_DEVICE.

Se você quiser relatar que todos os dispositivos em uma lista filho não estão disponíveis, seu driver pode simplesmente chamar WdfChildListBeginScan, seguido imediatamente por WdfChildListEndScan, em vez de chamar WdfChildListUpdateChildDescriptionAsMissing para cada dispositivo.

Para obter mais informações sobre dispositivos filho e listas filho, consulte de Enumeração Dinâmica.

Exemplos

O exemplo de código a seguir informa à estrutura que um dispositivo filho com um número de série especificado não está disponível.

PDO_IDENTIFICATION_DESCRIPTION  description;
NTSTATUS  status;

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

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
cabeçalho	wdfchildlist.h (inclua Wdf.h)
biblioteca	Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent

Compartilhar via