Método IWDFIoRequest3::SetUserModeDriverInitiatedIo (wudfddi.h)

  • Artigo

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método SetUserModeDriverInitiatedIo

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 ela fosse proveniente de um driver UMDF.

Sintaxe

void SetUserModeDriverInitiatedIo(
  [in] BOOL IsUserModeDriverInitiated
);

Parâmetros

[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.

Retornar valor

Nenhum

Comentários

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 membro Flags da estrutura WDM IRP 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 marcar para esse sinalizador determinar se a solicitação deve ser tratada como se fosse iniciada 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 um destino de E/S do Win32.

Um driver UMDF pode definir o parâmetro IsUserModeDriverInitiated como 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.

O EQUIVALENTE UMDF 2 desse método é WdfRequestSetUserModeDriverInitiatedIo.

Requisitos

Requisito Valor
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Área de Trabalho
Versão mínima do UMDF 1.11
Cabeçalho wudfddi.h (inclua Wudfddi.h)
DLL WUDFx.dll

Confira também

GetUserModeDriverInitiatedIo

IWDFIoRequest3

WdfRequestSetUserModeDriverInitiatedIo