Função StorPortSetPriorityThread (storport.h)

  • Artigo

StorPortSetPriorityThread define a prioridade de tempo de execução de um thread criado por miniport.

Sintaxe

ULONG StorPortSetPriorityThread(
  [in] PVOID                HwDeviceExtension,
  [in] PVOID                ThreadContext,
  [in] STOR_THREAD_PRIORITY Priority
);

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão de dispositivo de hardware do miniporto.

[in] ThreadContext

Ponteiro para o contexto de thread recebido em uma chamada anterior para StorPortCreateSystemThread.

[in] Priority

Um valor de enumeração STOR_THREAD_PRIORITY que especifica a prioridade de thread a ser definida.

Retornar valor

StorPortSetPriorityThread retorna um dos seguintes valores:

Código de retorno Descrição
STOR_STATUS_SUCCESS A prioridade de thread especificada foi definida com êxito.
STOR_STATUS_INVALID_IRQL O nível de IRQL deve ser igual a PASSIVE_LEVEL.
STOR_STATUS_INVALID_PARAMETER Um ou mais dos parâmetros fornecidos são inválidos.
STOR_STATUS_UNSUCCESSFUL Retornado por outros motivos internos do sistema.

Comentários

Um miniporto pode chamar StorPortSetPriorityThread para alterar a prioridade do thread especificado por ThreadContext.

Os threads, quaisquer que sejam suas respectivas prioridades de tempo de execução, são executados em IRQL = PASSIVE_LEVEL. Consulte Prioridades de thread para obter mais informações.

Um miniporto deve especificar um valor de prioridade de thread que evite inversões de prioridade em tempo de execução. Consulte Threads dedicados ao dispositivo para obter mais informações.

Requisitos

Requisito Valor
Servidor mínimo com suporte Windows Server 2022
Cabeçalho storport.h

Confira também

STOR_THREAD_PRIORITY

StorPortCreateSystemThread