Função WdfRequestSetUserModeDriverInitiatedIo (wdfrequest.h)
[Aplica-se somente ao UMDF]
O método WdfRequestSetUserModeDriverInitiatedIo indica aos drivers do modo kernel que ficam abaixo do driver UMDF na mesma pilha de dispositivos que uma solicitação específica deve ser tratada como se fosse proveniente de um driver UMDF.
Sintaxe
void WdfRequestSetUserModeDriverInitiatedIo(
[in] WDFREQUEST Request,
[in] BOOLEAN IsUserModeDriverInitiated
);
Parâmetros
[in] Request
Um identificador para um objeto de solicitação de estrutura.
[in] IsUserModeDriverInitiated
Um valor booliano que, se TRUE, indica que a solicitação deve ser tratada como se tivesse sido iniciada por um driver UMDF. Se FALSE, esse parâmetro indica que a solicitação deve ser tratada como se tivesse vindo de um aplicativo.
Valor de retorno
Nenhum
Observações
Se um driver UMDF chamar esse método com o parâmetro IsUserModeDriverInitiated definido como TRUE, a estrutura definirá o sinalizador IRP_UM_DRIVER_INITIATED_IO no Flags membro da estrutura de DO IRP WDM antes de encaminhar a solicitação para drivers no modo kernel.
Um driver no modo kernel que reside abaixo do driver UMDF na mesma pilha de dispositivos pode verificar se esse sinalizador deve ser tratado como se fosse iniciado por um driver UMDF.
Esse sinalizador não é aplicável a drivers no modo kernel que podem receber uma solicitação de um driver UMDF por meio de um destino de E/S de identificador de arquivo ou de um destino de E/S do Win32.
Um driver UMDF pode definir o parâmetro IsUserModeDriverInitiated para TRUE para uma solicitação que veio de um aplicativo se o driver tiver validado a solicitação.
As solicitações que o driver criou por conta própria já estão marcadas como tendo se originado de um driver UMDF.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8.1 |
| da Plataforma de Destino | Universal |
| versão mínima do UMDF | 2.0 |
| cabeçalho | wdfrequest.h (inclua Wdf.h) |
| biblioteca | WUDFx02000.lib; WUDFx02000.dll |
| IRQL | PASSIVE_LEVEL |