Função KeExpandKernelStackAndCalloutEx (ntddk.h)
A rotina KeExpandKernelStackAndCalloutEx chama uma rotina e garante que uma quantidade especificada de espaço de pilha esteja disponível para essa chamada.
Sintaxe
NTSTATUS KeExpandKernelStackAndCalloutEx(
PEXPAND_STACK_CALLOUT Callout,
PVOID Parameter,
SIZE_T Size,
BOOLEAN Wait,
PVOID Context
);
Parâmetros
Callout
Um ponteiro de função para uma rotina ExpandedStackCall . KeExpandKernelStackAndCalloutEx expande a pilha, se necessário, antes de chamar essa rotina.
Parameter
Especifica o valor do parâmetro a ser passado para a rotina ExpandedStackCall .
Size
Especifica o número de bytes de espaço de pilha para fornecer a chamada para a rotina ExpandedStackCall . Esse valor deve ser grande o suficiente para acomodar o uso da pilha da rotina ExpandedStackCall e de qualquer chamada que essa rotina possa fazer. O valor Tamanho não deve exceder MAXIMUM_EXPANSION_SIZE.
Wait
Especifica se a rotina deve aguardar para alocar o espaço de pilha necessário se esse espaço não estiver disponível imediatamente. Defina Aguardar como TRUE se a rotina puder aguardar a alocação de uma pilha expandida. Caso contrário, defina Wait como FALSE. Esse parâmetro deverá ser FALSE se KeExpandKernelStackAndCalloutEx for chamado em IRQL = DISPATCH_LEVEL.
Context
Reservado. Sempre defina esse parâmetro como NULL.
Retornar valor
KeExpandKernelStackAndCalloutEx retornará STATUS_SUCCESS se a chamada for bem-sucedida. Os possíveis valores retornados incluem os seguintes códigos de erro.
Código de retorno | Descrição |
---|---|
STATUS_INVALID_PARAMETER_3 | O parâmetro Size é maior que MAXIMUM_EXPANSION_SIZE. |
STATUS_INVALID_PARAMETER_4 | O parâmetro Wait é TRUE, mas a rotina foi chamada em IRQL = DISPATCH_LEVEL. |
STATUS_NO_MEMORY | Não há memória suficiente disponível para expandir a pilha. |
STATUS_STACK_OVERFLOW | A pilha, se expandida, excederia os limites internos do sistema operacional no espaço de pilha. |
Comentários
Essa rotina primeiro determina se um mínimo de bytes de tamanho está disponível na pilha atual para a chamada para a rotina ExpandedStackCall . Caso contrário, KeExpandKernelStackAndCalloutEx tenta expandir a pilha atual por Bytes de tamanho . Se a pilha atual não puder ser expandida por esse valor, KeExpandKernelStackAndCalloutEx alocará temporariamente um novo segmento de pilha de kernel. Se uma pilha do tamanho necessário estiver disponível, KeExpandKernelStackAndCalloutEx usará essa pilha para chamar a rotina ExpandedStackCall .
Se KeExpandKernelStackAndCalloutEx não conseguir obter o espaço de pilha necessário, ele retornará sem chamar a rotina ExpandedStackCall . KeExpandKernelStackAndCalloutEx retornará STATUS_SUCCESS somente se puder chamar a rotina ExpandedStackCall . Caso contrário, ele retornará um código de erro.
KeExpandKernelStackAndCalloutEx não é declarado em um arquivo de cabeçalho. Para usar essa rotina no driver, inclua a seguinte declaração de função no código do driver:
#if (NTDDI_VERSION >= NTDDI_VISTA)
__checkReturn
__drv_minIRQL(PASSIVE_LEVEL)
__drv_maxIRQL(DISPATCH_LEVEL)
__drv_reportError("DISPATCH_LEVEL is only supported on Windows 7 or later versions of Windows.")
NTKERNELAPI
NTSTATUS
KeExpandKernelStackAndCalloutEx (
__in PEXPAND_STACK_CALLOUT Callout,
__in_opt PVOID Parameter,
__in SIZE_T Size,
__in BOOLEAN Wait,
__in_opt PVOID Context
);
#endif
A rotina KeExpandKernelStackAndCallout é semelhante a KeExpandKernelStackAndCalloutEx , mas não tem parâmetros Wait e Context . Além disso, KeExpandKernelStackAndCallout sempre deve ser chamado em IRQL <= APC_LEVEL, enquanto KeExpandKernelStackAndCalloutEx pode ser chamado em DISPATCH_LEVEL (mas somente se Wait for FALSE).
O thread de chamada não deve chamar a rotina PsTerminateSystemThread até que a rotina ExpandedStackCall do thread retorne. PsTerminateSystemThread verifica se a rotina ExpandedStackCall ainda está ativa e, se estiver, causa um bug marcar.
No Windows Vista e no Windows Server 2008, KeExpandKernelStackAndCalloutEx deve ser chamado em IRQL <= APC_LEVEL. No Windows 7, Windows Server 2008 R2 e versões posteriores do Windows, essa rotina pode ser chamada em IRQL <= DISPATCH_LEVEL. No entanto, o parâmetro Wait deverá ser FALSE se a rotina for chamada em DISPATCH_LEVEL. Se Wait for TRUE, a chamada deverá ocorrer em IRQL <= APC_LEVEL.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível a partir do Windows Vista. |
Plataforma de Destino | Universal |
Cabeçalho | ntddk.h |
Biblioteca | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | Consulte a seção Observações. |
Confira também
ExpandedStackCallKeExpandKernelStackAndCalloutPsTerminateSystemThread