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

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtChildListCreateDevice de um motorista de ônibus 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 especificado pelo driver quando ele chamou WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] IdentificationDescription

Um ponteiro para uma cópia da estrutura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER especificada pelo driver quando ele chamou WdfChildListAddOrUpdateChildDescriptionAsPresent.

[in] ChildInit

Um ponteiro para uma estrutura WDFDEVICE_INIT.

Valor de retorno

A função de retorno de chamada EvtChildListCreateDevice deve retornar STATUS_SUCCESS ou outro valor de 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 de status para o qual NT_SUCCESS(status) é igual 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.

Observações

Se um driver de ônibus 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 framework.

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

Requisitos

Consulte também

WDFDEVICE_INIT

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListCreate

WdfChildListUpdateAllChildDescriptionsAsPresent

WdfDeviceCreate

WdfFdoInitSetDefaultChildListConfig