Função PosCxPutPendingEvent (poscx.h)
PosCxPutPendingEvent cria um novo objeto de evento, copia os dados do evento para o novo objeto de evento e tenta delegá-lo ao chamador em espera. Se o chamador de destino não tiver uma solicitação de leitura aguardando, o novo evento será adicionado à fila de eventos designada (controle ou dados).
Sintaxe
NTSTATUS PosCxPutPendingEvent(
[in] WDFDEVICE device,
[in] ULONG deviceInterfaceTag,
[in] ULONG eventType,
[in] size_t rawEventDataSize,
PVOID rawEventDataPtr,
[in] POS_CX_EVENT_ATTRIBUTES eventAttr
);
Parâmetros
[in] device
Um identificador para um objeto de dispositivo de estrutura que representa o dispositivo.
[in] deviceInterfaceTag
A interface do dispositivo associada ao evento. Por padrão, somente os objetos de arquivo que têm a mesma marca receberão esse evento.
[in] eventType
O novo tipo de evento.
[in] rawEventDataSize
O tamanho do buffer do evento bruto (sem cabeçalho de ponto de serviço) em bytes.
rawEventDataPtr
O ponteiro para os dados de evento brutos (sem cabeçalho de ponto de serviço). O chamador pode reutilizar/liberar rawEventDataPtr depois que PosCxPutPendingEvent retornar.
[in] eventAttr
Os atributos do evento.
Retornar valor
Os valores retornados possíveis são:
| Valor | Descrição |
|---|---|
| STATUS_SUCCESS | O evento foi criado e delegado a um chamador em espera ou o evento foi descartado porque não há proprietário do dispositivo. |
| STATUS_PENDING | O evento foi enfileirado porque nenhum chamador está aguardando no momento. |
| Outros erros | Outros códigos de erro de falha apropriados. |
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | poscx.h (inclua Poscx.h) |