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 de StrMiniClock de um fluxo ou retorna uma estrutura de HW_TIME_CONTEXT concluída quando responde a uma StreamClassQueryMasterClock ou solicitação 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 do 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 HwDeviceExtension membro do HW_STREAM_OBJECT, HW_STREAM_REQUEST_BLOCKe 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 de 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 pelo 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 do relógio atual.

Time

O valor de tempo, em unidades de 100 nanossegundos, especificado pelo membro da Função.

SystemTime

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

Requisitos

Consulte também

HW_CLOCK_OBJECT

StrMiniClock

StreamClassQueryMasterClock

StreamClassQueryMasterClockSync