Función WmiCompleteRequest (wmilib.h)

Artículo
08/08/2023

La rutina WmiCompleteRequest indica que un controlador ha terminado de procesar una solicitud WMI en una rutina DpWmiXxx .

Sintaxis

NTSTATUS WmiCompleteRequest(
  [in]      PDEVICE_OBJECT DeviceObject,
  [in, out] PIRP           Irp,
  [in]      NTSTATUS       Status,
  [in]      ULONG          BufferUsed,
  [in]      CCHAR          PriorityBoost
);

Parámetros

[in] DeviceObject

Puntero al DEVICE_OBJECT del controlador.

[in, out] Irp

Puntero al IRP.

[in] Status

Especifica el estado que se va a devolver para el IRP.

[in] BufferUsed

Especifica el número de bytes necesarios en el búfer pasado a la rutina DpWmiXxx del controlador. Si el búfer es demasiado pequeño, el controlador establece Status en STATUS_BUFFER_TOO_SMALL y establece BufferUsed en el número de bytes necesarios para que se devuelvan los datos. Si el búfer pasado es lo suficientemente grande, el controlador establece BufferUsed en el número de bytes que se usan realmente.

[in] PriorityBoost

Especifica una constante definida por el sistema por la que se incrementa la prioridad en tiempo de ejecución del subproceso original que solicitó la operación. WMI llama a IoCompleteRequest con PriorityBoost cuando completa el IRP. Consulte IoCompleteRequest para obtener más información sobre PriorityBoost.

Valor devuelto

WmiCompleteRequest devuelve el valor que se le pasó en el parámetro Status a menos que Status se haya establecido en STATUS_BUFFER_TOO_SMALL. Si el controlador establece Status igual a STATUS_BUFFER_TOO_SMALL, WmiCompleteRequest compila una estructura de WNODE_TOO_SMALL y devuelve STATUS_SUCCESS. El controlador debe devolver el valor devuelto de WmiCompleteRequest en su rutina DpWmiXxx .

Comentarios

Un controlador llama a WmiCompleteRequest desde una rutina DpWmiXxx después de finalizar el resto del procesamiento de esa rutina, o después de que el controlador finalice todo el procesamiento de un IRP pendiente. WmiCompleteRequest rellena un WNODE_XXX con los datos devueltos por el controlador y llama a IoCompleteRequest para completar el IRP.

Un controlador siempre debe devolver el valor devuelto de WmiCompleteRequest en su rutina DpWmiXxx .

Un controlador no debe llamar a WmiCompleteRequest desde su rutina DpWmiQueryRegInfo .

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wmilib.h (incluya Wmilib.h)
Library	Wmilib.lib
IRQL	<= DISPATCH_LEVEL