Função de retorno de chamada POFXCALLBACKREQUESTINTERRUPT (pep_x.h)

  • Artigo

A rotina RequestInterrupt solicita que o sistema operacional reproduza uma interrupção disparada por borda que pode ter sido perdida enquanto a plataforma de hardware estava em um estado de baixa potência.

Sintaxe

POFXCALLBACKREQUESTINTERRUPT Pofxcallbackrequestinterrupt;

NTSTATUS Pofxcallbackrequestinterrupt(
  [in] ULONG Gsiv
)
{...}

Parâmetros

[in] Gsiv

O número do GSIV (vetor de interrupção do sistema global) que identifica essa interrupção. O firmware ACPI atribui números GSIV a todas as linhas de interrupção primárias. Para linhas de interrupção (GPIO) secundárias, o número GSIV é atribuído dinamicamente pelo sistema operacional.

Retornar valor

RequestInterrupt retornará STATUS_SUCCESS se a interrupção especificada for reproduzida com êxito. Os possíveis valores retornados por erro incluem o código de status a seguir.

Código de retorno Descrição
STATUS_INVALID_PARAMETER
 Não é um número GSIV válido.

Comentários

Essa rotina é implementada pela PoFx (estrutura de gerenciamento de energia) e é chamada pelo PEP (plug-in de extensão de plataforma). O membro RequestInterrupt da estrutura PEP_KERNEL_INFORMATION_STRUCT_V3 é um ponteiro para uma rotina RequestInterrupt .

A asserção de um sinal de interrupção disparado por borda é transitória por natureza e pode ser perdida se a energia de um controlador de interrupção primário for fechada quando a interrupção ocorrer. Por outro lado, espera-se que um sinal de interrupção disparado por nível permaneça declarado até que possa ser atendido.

Um PEP pode chamar essa rotina em IRQL <= HIGH_LEVEL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte a partir do Windows 10.
Plataforma de Destino Windows
Cabeçalho pep_x.h (inclua Pep_x.h)
IRQL <= HIGH_LEVEL

Confira também

PEP_KERNEL_INFORMATION_STRUCT_V3