Função WdfRequestSetInformation (wdfrequest.h)

Artigo
07/02/2025

[Aplica-se a KMDF e UMDF]

O método WdfRequestSetInformation define informações de status de conclusão para uma solicitação de E/S especificada.

Sintaxe

void WdfRequestSetInformation(
  [in] WDFREQUEST Request,
  [in] ULONG_PTR  Information
);

Parâmetros

[in] Request

Um identificador para um objeto de solicitação de estrutura.

[in] Information

Informações de status de conclusão definidas pelo driver para a solicitação.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Os drivers baseados em estrutura usam o método WdfRequestSetInformation para fornecer informações específicas do driver associadas à conclusão de uma solicitação de E/S, como o número de bytes transferidos. Outros drivers podem obter essas informações chamando WdfRequestGetInformation.

Os drivers também podem especificar informações de status de conclusão chamando WdfRequestCompleteWithInformation.

Para obter mais informações sobre WdfRequestSetInformation, consulte Concluindo solicitações de E/S.

Exemplos

O exemplo de código a seguir define informações de conclusão de solicitação baseadas no valor do código de controle de E/S que uma função de retorno de chamada EvtIoDeviceControl recebe.

VOID
MyEvtIoDeviceControl(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  OutputBufferLength,
    IN size_t  InputBufferLength,
    IN ULONG  IoControlCode
    )
{
    switch (IoControlCode) {
      case MY_IOCTL_CODE_1:
            WdfRequestSetInformation(
                                     Request,
                                     VALUE_1
                                     );
            status = STATUS_SUCCESS;                                     
            break;

      case MY_IOCTL_CODE_2:
            WdfRequestSetInformation(
                                     Request,
                                     VALUE_2
                                     );
            status = STATUS_SUCCESS;                                     
            break;

      case MY_IOCTL_CODE_3:
            WdfRequestSetInformation(
                                     Request,
                                     VALUE_3
                                     );
            status = STATUS_SUCCESS;
            break;

      default:
            status = STATUS_INVALID_DEVICE_REQUEST;
            break;
    }

    WdfRequestComplete(
                       Request,
                       status
                       );
}

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
versão mínima do UMDF	2.0
cabeçalho	wdfrequest.h (inclua Wdf.h)
biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), kmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

WdfRequestCompleteWithInformation

WdfRequestGetInformation

Compartilhar via