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

  • Artículo

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 de cliente. Este espacio de memoria está disponible para su uso por parte del controlador cliente. WdfDeviceCreate asigna como parte del espacio de contexto del objeto de marco. Para obtener más información, vea HWN_CLIENT_REGISTRATION_PACKET y Espacio de contexto de objetos de marco.

[out] OutputBuffer

Búfer de bytes OutputBufferLength para escribir el estado de notificación de hardware. Si la función se realiza 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 la sección Comentarios.

 

[in] OutputBufferLength

Tamaño de OutputBuffer en bytes.

[in] InputBuffer

Búfer de bytes InputBufferLength que contienen un 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 . 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.

Comentarios

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

  • Si InputBuffer es NULL, el búfer de salida se usará para almacenar una estructura de HWN_HEADER que contiene 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 HWN_SETTINGS .

  • Si InputBuffer no es null y tiene el formato correcto, contendrá un HWN_HEADER con una o varias estructuras HWN_SETTINGS . Los identificadores de los componentes de notificación de hardware solicitados se almacenan en el campo HwNId de la estructura 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 Value
Cliente mínimo compatible Windows 10, versión 1709
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado hwnclx.h
IRQL PASSIVE_LEVEL

Consulte también

Compatibilidad con notificaciones de hardware

Referencia de notificaciones de hardware