Função WdfChildListUpdateChildDescriptionAsMissing (wdfchildlist.h)

  • Artigo

[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 filho fornecida pelo driver.

Retornar valor

WdfChildListUpdateChildDescriptionAsMissing retorna STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE, se a operação for bem-sucedida. Caso contrário, esse método pode 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 para a 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.

Um bug do sistema marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Seu driver pode relatar que um dispositivo está indisponí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 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
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfchildlist.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <= DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent