Função RxPostToWorkerThread (rxworkq.h)
RxPostToWorkerThread invoca uma rotina passada como um parâmetro no contexto de um thread de trabalho. A memória do WORK_QUEUE_ITEM deve ser alocada pelo chamador.
Sintaxe
NTSTATUS RxPostToWorkerThread(
[in] IN PRDBSS_DEVICE_OBJECT pMRxDeviceObject,
[in] IN WORK_QUEUE_TYPE WorkQueueType,
[in] IN PRX_WORK_QUEUE_ITEM pWorkQueueItem,
[in] IN PRX_WORKERTHREAD_ROUTINE Routine,
[in] IN PVOID pContext
);
Parâmetros
[in] pMRxDeviceObject
Um ponteiro para o objeto de dispositivo do driver de minidiretório de rede correspondente.
[in] WorkQueueType
O tipo da fila de trabalho que representa a prioridade da tarefa. Esse parâmetro pode usar um dos valores a seguir:
CriticalWorkQueue
Insira WORK_QUEUE_ITEM na fila da qual um thread do sistema com um atributo de prioridade em tempo real processará o item de trabalho.
DelayedWorkQueue
Insira WORK_QUEUE_ITEM na fila da qual um thread do sistema com um atributo de prioridade variável processará o item de trabalho.
HyperCriticalWorkQueue
Insira WORK_QUEUE_ITEM na fila da qual um thread do sistema processará o item de trabalho para que a rotina a ser invocada não seja bloqueada.
[in] pWorkQueueItem
Um ponteiro para WORK_QUEUE_ITEM.
[in] Routine
Um ponteiro para a rotina a ser invocada.
[in] pContext
Um ponteiro para um parâmetro de contexto associado ao item de trabalho a ser concluído que é passado para o driver.
Retornar valor
RxDispatchToWorkerThread retorna STATUS_SUCCESS com êxito ou um dos seguintes códigos de erro em caso de falha:
Código de retorno | Descrição |
---|---|
|
Não foi possível expedir o item. |
Comentários
Há dois casos comuns de operações de expedição para threads de trabalho. A compensação entre as duas operações de expedição a seguir é tempo versus espaço (uso de memória):
- Quando uma operação é enviada repetidamente, o tempo é conservado alocando com antecedência a estrutura WORK_QUEUE_ITEM como parte da estrutura de dados a ser expedida. Nesse caso, use a rotina RxPostToWorkerThread .
- Para uma operação pouco frequente, você pode economizar espaço alocando e liberando memória dinamicamente para o item de fila de trabalho quando necessário. Nesse caso, use a rotina RxDispatchToWorkerThread .
A implementação atual das filas de rotina RxPostToWorkerThread funciona no mesmo processador do qual a chamada se originou.
Se a rotina RxPostToWorkerThread falhar em um build de depuração, a rotina _RxLog será chamada com detalhes do erro. Se a rotina RxPostToWorkerThread falhar e o WMI estiver habilitado no kernel, os detalhes do erro serão registrados com wmi.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Área de Trabalho |
Cabeçalho | rxworkq.h (inclua Rxworkq.h, Rxstruc.h, Ntifs.h) |
IRQL | <= APC_LEVEL |