Função HwNProcessAddDevicePreDeviceCreate (hwnclx.h)
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 |