EVT_WDF_CHILD_LIST_CREATE_DEVICE função de retorno de chamada (wdfchildlist.h)

Artigo
08/08/2023

[Aplica-se somente ao KMDF]

A função de retorno de chamada de eventoEvtChildListCreateDevice de um driver de barramento cria um objeto de dispositivo de estrutura para um novo dispositivo que foi enumerado dinamicamente.

Sintaxe

EVT_WDF_CHILD_LIST_CREATE_DEVICE EvtWdfChildListCreateDevice;

NTSTATUS EvtWdfChildListCreateDevice(
  [in] WDFCHILDLIST ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription,
  [in] PWDFDEVICE_INIT ChildInit
)
{...}

Parâmetros

[in] ChildList

Um identificador para o objeto de lista filho da estrutura que o driver especificou quando chamou WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] IdentificationDescription

Um ponteiro para uma cópia da estrutura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER que o driver especificou quando chamou WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] ChildInit

Um ponteiro para uma estrutura WDFDEVICE_INIT .

Retornar valor

A função de retorno de chamada EvtChildListCreateDevice deve retornar 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, essa função deve retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE.

Se a operação falhou, mas você acha que o driver deve tentar novamente mais tarde e, se a função de retorno de chamada EvtChildListCreateDevice do driver não tiver chamado WdfDeviceCreate, o driver poderá retornar STATUS_RETRY. Como resultado, a estrutura chama a função de retorno de chamada EvtChildListCreateDevice novamente mais tarde. Se o driver retornar STATUS_RETRY mais de algumas vezes, a estrutura deixará de chamar a função de retorno de chamada para o dispositivo com falha.

Comentários

Se um driver de barramento estiver usando enumeração dinâmica, ele poderá registrar uma função de retorno de chamada EvtChildListCreateDevice chamando WdfFdoInitSetDefaultChildListConfig ou WdfChildListCreate.

Depois que um driver chama WdfChildListAddOrUpdateChildDescriptionAsPresent ou WdfChildListUpdateAllChildDescriptionsAsPresent, a estrutura chama a função de retorno de chamada EvtChildListCreateDevice do driver. A função de retorno de chamada deve chamar WdfDeviceCreate para criar um objeto de dispositivo de estrutura (um PDO).

Antes de chamar WdfDeviceCreate, o driver deve chamar funções fornecidas pela estrutura que inicializam a estrutura WDFDEVICE_INIT. Para obter mais informações sobre essas funções, consulte WDFDEVICE_INIT.

Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo de estrutura.

Para obter mais informações sobre enumeração dinâmica, consulte Enumerando os dispositivos em um barramento.