Função HwNProcessAddDevicePreDeviceCreate (hwnclx.h)

  • Artigo

Fornece os retornos de chamada de preparação/lançamento e entrada/saída do dispositivo para o WDF (Windows Driver Foundation) para fazer a transição do dispositivo para estados diferentes. Essa função deve ser chamada pelo driver do cliente quando o WDF invoca a rotina de EVT_WDF_DRIVER_DEVICE_ADD do driver, mas antes de criar o objeto do dispositivo.

Sintaxe

FORCEINLINE NTSTATUS  HwNProcessAddDevicePreDeviceCreate(
  _In_  WDFDRIVER               Driver,
  _In_  PWDFDEVICE_INIT         DeviceInit,
  _Out_ PWDF_OBJECT_ATTRIBUTES  FdoAttributes
);

Parâmetros

[in] Driver

Manipule para o objeto de driver da estrutura de drivers do cliente.

[in] DeviceInit

Um ponteiro para uma estrutura de WDFDEVICE_INIT alocada por estrutura.

[out] FdoAttributes

Ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que descreve os atributos do objeto de dispositivo do driver cliente quando ele é criado.

Retornar valor

Retorna STATUS_SUCCESS se a função for bem-sucedida. Retorna STATUS_INVALID_PARAMETER se o driver de cliente correspondente não puder ser encontrado. Caso contrário, ele retornará um dos valores de status de erro definidos em Ntstatus.h.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho hwnclx.h
Biblioteca Mshwnclxstub.lib
IRQL PASSIVE_LEVEL

Confira também

Suporte a notificações de hardware

Referência de notificações de hardware