estrutura HW_TIME_CONTEXT (strmini.h)

O driver de classe passa uma estrutura HW_TIME_CONTEXT como um parâmetro a ser preenchido pela rotina StrMiniClock de um fluxo ou retorna uma estrutura de HW_TIME_CONTEXT concluída quando responde a uma solicitação StreamClassQueryMasterClock ou StreamClassQueryMasterClockSync .

Sintaxe

typedef struct _HW_TIME_CONTEXT {
  struct _HW_DEVICE_EXTENSION *HwDeviceExtension;
  struct _HW_STREAM_OBJECT    *HwStreamObject;
  TIME_FUNCTION               Function;
  ULONGLONG                   Time;
  ULONGLONG                   SystemTime;
} HW_TIME_CONTEXT, *PHW_TIME_CONTEXT;

Membros

HwDeviceExtension

Aponta para o buffer de extensão de dispositivo do minidriver. O driver de classe preenche esse membro quando ele passa a estrutura para o StrMiniClock de um fluxo ou para o retorno de chamada passado para StreamClassQueryMasterClock. Quando passado como um parâmetro para StreamClassQueryMasterClockSync, o chamador deve preencher esse próprio membro.

O minidriver pode usar sua extensão de dispositivo para registrar informações privadas globais no minidriver. O minidriver define o tamanho desse buffer na estrutura HW_INITIALIZATION_DATA que ele passa quando ele se registra por meio de StreamClassRegisterMinidriver. O driver de classe também passa ponteiros para esse buffer no membro HwDeviceExtension do HW_STREAM_OBJECT, HW_STREAM_REQUEST_BLOCK e PORT_CONFIGURATION_INFORMATION estruturas que ele passa para o minidriver.

HwStreamObject

Quando o driver de classe passa HW_TIME_CONTEXT para a rotina StrMiniClock de um fluxo, esse membro aponta para a estrutura HW_STREAM_OBJECT do fluxo.

Quando o driver de classe passa uma estrutura de HW_TIME_CONTEXT concluída para o retorno de chamada fornecido por StreamClassQueryMasterClock, ele preenche esse membro com um ponteiro para o objeto de fluxo do fluxo que faz a solicitação de consulta.

Function

Especifica o tipo de valor de tempo armazenado no membro Time . Os valores possíveis são:

TIME_GET_STREAM_TIME

O membro Time contém o carimbo de data/hora da apresentação atual.

TIME_READ_ONBOARD_CLOCK

O membro Time mantém a hora atual do relógio.

Time

O valor de tempo, em unidades de 100 nanossegundos, especificado pelo membro function .

SystemTime

A hora atual do sistema, em unidades de 100 nanossegundos.

Requisitos

Confira também

HW_CLOCK_OBJECT

StrMiniClock

StreamClassQueryMasterClock

StreamClassQueryMasterClockSync