Função WmiCompleteRequest (wmilib.h)
A rotina WmiCompleteRequest indica que um driver terminou de processar uma solicitação WMI em uma rotina de DpWmiXxx.
Sintaxe
NTSTATUS WmiCompleteRequest(
[in] PDEVICE_OBJECT DeviceObject,
[in, out] PIRP Irp,
[in] NTSTATUS Status,
[in] ULONG BufferUsed,
[in] CCHAR PriorityBoost
);
Parâmetros
[in] DeviceObject
Um ponteiro para o DEVICE_OBJECTdo driver.
[in, out] Irp
Um ponteiro para o IRP.
[in] Status
Especifica o status a ser retornado para o IRP.
[in] BufferUsed
Especifica o número de bytes necessários no buffer passado para a rotina de DpWmiXxx do driver. Se o buffer for muito pequeno, o driver definirá Status para STATUS_BUFFER_TOO_SMALL e definirá bufferUsed para o número de bytes necessários para que os dados sejam retornados. Se o buffer passado for grande o suficiente, o driver definirá bufferUsed para o número de bytes realmente usados.
[in] PriorityBoost
Especifica uma constante definida pelo sistema pela qual incrementar a prioridade de tempo de execução do thread original que solicitou a operação. O WMI chama IoCompleteRequest com PriorityBoost ao concluir o IRP. Consulte IoCompleteRequest para obter mais informações sobre PriorityBoost.
Valor de retorno
WmiCompleteRequest retorna o valor que foi passado para ele no parâmetro Status, a menos que status foi definido como STATUS_BUFFER_TOO_SMALL. Se o driver definir Status igual a STATUS_BUFFER_TOO_SMALL, WmiCompleteRequest criará uma estrutura WNODE_TOO_SMALL e retornará STATUS_SUCCESS. O valor retornado de WmiCompleteRequest deve ser retornado pelo driver em sua rotina de DpWmiXxx.
Observações
Um driver chama WmiCompleteRequest de uma rotina de DpWmiXxx depois de concluir todo o processamento nessa rotina ou depois que o driver concluir todo o processamento de um IRP pendente. WmiCompleteRequest preenche umaXXX WNODE_com quaisquer dados retornados pelo driver e chamadas IoCompleteRequest para concluir o IRP.
Um driver sempre deve retornar o valor retornado de WmiCompleteRequest em sua rotina de DpWmiXxx.
Um driver não deve chamar WmiCompleteRequest de sua rotina de DpWmiQueryRegInfo.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wmilib.h (inclua Wmilib.h) |
| biblioteca | Wmilib.lib |
| IRQL | <= DISPATCH_LEVEL |