Função WdfRequestSetUserModeDriverInitiatedIo (wdfrequest.h)

  • Artigo

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

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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1
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

Confira também

WdfRequestGetUserModeDriverInitiatedIo