EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT função de retorno de chamada (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

A função de retorno de chamada de evento EvtDeviceSelfManagedIoInit de um driver inicializa e inicia as operações de E/S autogerenciadas do dispositivo.

Sintaxe

EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT EvtWdfDeviceSelfManagedIoInit;

NTSTATUS EvtWdfDeviceSelfManagedIoInit(
  [in] WDFDEVICE Device
)
{...}

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

Retornar valor

Se a função de retorno de chamada EvtDeviceSelfManagedIoInit não encontrar erros, ela deverá retornar STATUS_SUCCESS ou outro valor status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE. Se NT_SUCCESS(status) for igual a FALSE, a estrutura não iniciará o dispositivo.

Se NT_SUCCESS(status) for igual a FALSE, a estrutura chamará as funções de retorno de chamada EvtDeviceSelfManagedIoFlush e EvtDeviceSelfManagedIoCleanup do driver.

Para obter mais informações sobre os valores retornados dessa função de retorno de chamada, consulte Relatando falhas de dispositivo.

Comentários

Para registrar uma função de retorno de chamada EvtDeviceSelfManagedIoInit , um driver deve chamar WdfDeviceInitSetPnpPowerEventCallbacks.

Se o driver tiver registrado uma função de retorno de chamada EvtDeviceSelfManagedIoInit , a estrutura a chamará uma vez para cada dispositivo, depois que a estrutura tiver chamado a função de retorno de chamada EvtDeviceD0Entry do driver pela primeira vez. A estrutura não chama a função de retorno de chamada EvtDeviceSelfManagedIoInit novamente para esse dispositivo, a menos que o dispositivo seja removido e reconectado ou os drivers sejam recarregados.

A função de retorno de chamada EvtDeviceSelfManagedIoInit deve inicializar e iniciar as operações de E/S autogerenciadas que o driver manipulará para o dispositivo.

Para obter mais informações sobre quando a estrutura chama essa função de retorno de chamada, consulte Cenários de gerenciamento de energia e PnP.

Para obter mais informações sobre drivers que fornecem essa função de retorno de chamada, consulte Usando Self-Managed E/S.

Requisitos

Confira também

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoRestart

EvtDeviceSelfManagedIoSuspend