Função KeInsertQueueDpc (wdm.h)
O KeInsertQueueDpc filas de rotina de um DPC para execução.
Sintaxe
BOOLEAN KeInsertQueueDpc(
[in, out] PRKDPC Dpc,
[in, optional] PVOID SystemArgument1,
[in, optional] __drv_aliasesMem PVOID SystemArgument2
);
Parâmetros
[in, out] Dpc
Ponteiro para a estrutura de KDPC para o objeto DPC. Essa estrutura deve ter sido inicializada por KeInitializeDpc ou KeInitializeThreadedDpc.
[in, optional] SystemArgument1
Especifica dados de contexto determinados pelo driver. Esse valor é passado como o parâmetro SystemArgument1 para o CustomDpc do objeto DPC ou rotina de CustomThreadedDpc.
[in, optional] SystemArgument2
Especifica dados de contexto determinados pelo driver. Esse valor é passado como o parâmetro SystemArgument2 para o customDpc do objeto do DPC ou rotina de CustomThreadedDpc do objeto DPC.
Valor de retorno
Se o objeto DPC especificado não estiver atualmente em uma fila DPC, KeInsertQueueDpc enfileira o DPC e retorna VERDADEIRO.
Observações
Se o objeto DPC especificado já tiver sido enfileirado, nenhuma operação será executada, exceto para retornar FALSE. Caso contrário, o objeto DPC será inserido em uma fila DPC. Para obter mais informações sobre filas DPC, consulte Organização de Filas DPC.
Observe que um objeto DPC específico e a função que ele representa podem ser enfileirados para execução apenas uma vez em qualquer momento específico.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | Qualquer nível |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), MarkingQueuedIrps(wdm) |