HWN_CLIENT_GET_STATE función de devolución de llamada (hwnclx.h)

2025-02-07

Implementado por el controlador cliente para obtener el estado del componente de notificación de hardware. Se invoca cuando un usuario solicita información de estado.

Sintaxis

HWN_CLIENT_GET_STATE HwnClientGetState;

NTSTATUS HwnClientGetState(
  [in]  PVOID Context,
  [out] PVOID OutputBuffer,
  [in]  ULONG OutputBufferLength,
  [in]  PVOID InputBuffer,
  [in]  ULONG InputBufferLength,
  [out] PULONG BytesRead
)
{...}

Parámetros

[in] Context

Puntero a la información de contexto del controlador cliente. Este espacio de memoria está disponible para su uso por parte del controlador cliente. Se asigna como parte del espacio de contexto del objeto de marco WdfDeviceCreate. Para obtener más información, vea HWN_CLIENT_REGISTRATION_PACKET y Framework Object Context Space.

[out] OutputBuffer

Búfer de OutputBufferLength bytes para escribir el estado de notificación de hardware. Si la función se ejecuta correctamente, el búfer contendrá una estructura de HWN_HEADER, incluidas una o varias estructuras de HWN_SETTINGS.

nota

OutputBufferLength debe ser lo suficientemente grande como para contener toda la configuración solicitada. Para obtener más información, vea Comentarios.

[in] OutputBufferLength

Tamaño de OutputBuffer en bytes.

[in] InputBuffer

Búfer de bytes inputBufferLength que contienen una HWN_HEADER que contiene una o varias estructuras de HWN_SETTINGS donde los identificadores de los componentes de notificación de hardware solicitados se almacenan en el campo HwNId de. Este búfer puede ser NULL.

[in] InputBufferLength

Tamaño de InputBuffer en bytes.

[out] BytesRead

Puntero a una variable que indica el número de bytes leídos por la función.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error NTSTATUS adecuado.

Observaciones

Registre la implementación de esta función de devolución de llamada estableciendo el miembro adecuado de HWN_CLIENT_REGISTRATION_PACKET y llamando a HwNRegisterClient.

Si InputBuffer es NULL, el búfer de salida se usará para almacenar una estructura de HWN_HEADER que contenga toda la configuración de las notificaciones de hardware implementadas por el controlador.
La configuración de un componente de notificación de hardware se almacena en una estructura de HWN_SETTINGS. El campo HwNSettingsInfo de la estructura HWN_HEADER contiene una matriz de estructuras de HWN_SETTINGS.
Si InputBuffer no es null y tiene el formato correcto, contendrá un HWN_HEADER con una o varias estructuras de HWN_SETTINGS. Los identificadores de los componentes de notificación de hardware solicitados se almacenan en el campo HwNId de de la estructura de HWN_SETTINGS. La configuración restante debe ser válida o cero.
Si OutputBuffer no es lo suficientemente grande como para contener toda la configuración solicitada, esta función no debe escribir nada en OutputBuffer. Además, debe establecer BytesRead en 0 y devolver un error.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1709
servidor mínimo admitido	Windows Server 2016
de la plataforma de destino de	Windows
encabezado de	hwnclx.h
irQL	PASSIVE_LEVEL

Consulte también

las notificaciones de hardware admiten

referencia de notificaciones de hardware