Função WdfChildListRequestChildEject (wdfchildlist.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfChildListRequestChildEject informa à estrutura que um dispositivo especificado está prestes a ser ejetado de sua estação de encaixe.

Sintaxe

BOOLEAN WdfChildListRequestChildEject(
  [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.

Retornar valor

WdfChildListRequestChildEject retornará TRUE se a operação for bem-sucedida. Se um parâmetro de entrada for inválido ou se a estrutura não puder localizar o dispositivo na lista filho, o método retornará FALSE.

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

Comentários

Um motorista de ônibus pode chamar WdfChildListRequestChildEject ou WdfPdoRequestEject para relatar que o driver detectou uma tentativa de ejetar um de seus dispositivos filho enumerados da estação de encaixe do dispositivo. Por exemplo, o driver pode detectar que um usuário efetuou push de um botão ejetar.

Se o driver estiver usando a enumeração de barramento dinâmico e se a descrição de identificação do dispositivo estiver disponível, o driver poderá chamar WdfChildListRequestChildEject. Se o objeto de dispositivo de estrutura para o PDO do dispositivo estiver disponível, o driver poderá chamar WdfPdoRequestEject.

O parâmetro IdentificationDescription do método WdfChildListRequestChildEject identifica o dispositivo que está sendo ejetado. O dispositivo deve ser um membro da lista filho que o parâmetro ChildList representa.

A estrutura usa a descrição de identificação para localizar o dispositivo na lista filho.

Para obter mais informações sobre listas filho, consulte Enumeração dinâmica.

Para obter mais informações sobre dispositivos ejetáveis, consulte Suporte a dispositivos ejetáveis.

Exemplos

Para obter um exemplo de código que usa WdfChildListRequestChildEject, consulte WdfChildListRetrieveNextDevice.

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

WdfPdoRequestEject