estrutura KSSTREAM_HEADER (ks.h)
A estrutura KSSTREAM_HEADER é uma estrutura de comprimento variável que descreve um pacote de dados a serem lidos ou gravados em um pino de driver de streaming.
Sintaxe
typedef struct {
ULONG Size;
ULONG TypeSpecificFlags;
KSTIME PresentationTime;
LONGLONG Duration;
ULONG FrameExtent;
ULONG DataUsed;
PVOID Data;
ULONG OptionsFlags;
ULONG Reserved;
} KSSTREAM_HEADER, *PKSSTREAM_HEADER;
Membros
Size
Especifica o tamanho, em bytes, da estrutura . Deve ser pelo menos sizeof(KSSTREAM_HEADER).
TypeSpecificFlags
Especifica sinalizadores específicos para um formato de dados. O único sinalizador com suporte no momento para TypeSpecificFlags é KS_AM_UseNewCSSKey. Esse sinalizador indica que o decodificador de hardware deve alternar para a próxima chave de descriptografia CSS (Content Scramble System) enfileirada, pois o exemplo de dados que segue imediatamente o cabeçalho é o primeiro exemplo de dados ao qual uma nova chave de título se aplica.
PresentationTime
Uma estrutura KSTIME que especifica o tempo de apresentação para o buffer de fluxo relacionado em unidades de 100 nanossegundos. Para obter mais informações, consulte a seção Comentários.
Duration
Especifica a duração desse segmento de fluxo nas mesmas unidades que o tempo de apresentação (unidades de 100 nanossegundos). Defina como zero quando não for usado.
FrameExtent
Especifica o tamanho do quadro inteiro. A região dentro da extensão do quadro está disponível para o filtro e o tamanho de dados válido resultante para a operação de fluxo é refletido no membro DataUsed .
DataUsed
Para uma operação de gravação, esse membro especifica o número de bytes dentro do quadro que são válidos ao enviar um quadro para um driver de nível inferior. Os cabeçalhos não são modificados em uma operação de gravação; no entanto, o membro Information da estrutura IO_STATUS_BLOCK contém o número total de bytes realmente gravados. Para uma operação de leitura, esse membro não é usado ao enviar um quadro para um driver de nível inferior e deve ser definido como zero. No retorno, esse membro contém o número de bytes realmente preenchidos nesse quadro e o membro Information da estrutura IO_STATUS_BLOCK contém o tamanho da lista de cabeçalhos realmente usados. Observe que, se o minidriver especificar KSPIN_FLAG_GENERATE_MAPPINGS em KSPIN_DESCRIPTOR_EX, quando um ponteiro de fluxo for avançado após um quadro, DataUsed será definido como Contagem menos Restante (membros de KSSTREAM_POINTER_OFFSET). Se o driver não especificar esse sinalizador, o minidriver será responsável por definir DataUsed.
Data
Especifica o endereço virtual do buffer de dados.
OptionsFlags
Especifica uma variedade de atributos do fluxo de dados. O membro OptionsFlags pode ter os valores listados na tabela a seguir.
| Valor | Descrição |
|---|---|
| KSSTREAM_HEADER_OPTIONSF_DATADISCONTINUITY | Especifica que houve uma descontinuidade no fluxo de dados antes dos dados contidos neste pacote. Isso implica que o filtro pode precisar redefinir seu estado interno antes de processar os dados. Nenhum buffer de dados real precisa ser anexado. |
| KSSTREAM_HEADER_OPTIONSF_DURATIONVALID | Especifica que o membro Duration dessa estrutura é válido. |
| KSSTREAM_HEADER_OPTIONSF_ENDOFPHOTOSEQUENCE | Indica que esse quadro representa o final de uma sequência de fotos. |
| KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM | Indica que esse quadro representa o final do fluxo de dados. |
| KSSTREAM_HEADER_OPTIONSF_FLUSHONPAUSE | Se o fluxo estiver em pausa, esse buffer deverá ser liberado. Esse sinalizador é usado, por exemplo, por fontes de dados dinâmicas, em que uma pausa torna os dados atuais obsoletos. |
| KSSTREAM_HEADER_OPTIONSF_FRAMEINFO | Indica que há uma estrutura KS_FRAME_INFO após KSSTREAM_HEADER. |
| KSSTREAM_HEADER_OPTIONSF_LOOPEDDATA | Esse buffer de dados é o início de dados em loop. O driver deve executar um loop nesses dados até que seja interrompido explicitamente. |
| KSSTREAM_HEADER_OPTIONSF_METADATA | Indica que há uma KSSTREAM_METADATA_INFO que segue KS_FRAME_INFO após o KSSTREAM_HEADER. Esse sinalizador estará presente somente se KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA tiver suporte. |
| KSSTREAM_HEADER_OPTIONSF_PREROLL | Os dados nesse buffer são usados para preparar o estado do dispositivo. Essa é uma opção específica do fluxo. |
| KSSTREAM_HEADER_OPTIONSF_SPLICEPOINT | O fluxo de dados está em um ponto natural para a junção. Um cliente usa isso, por exemplo, ao enviar dados que usam compactação entre quadros, como vídeo MPEG, para indicar que é seguro unir neste ponto. |
| KSSTREAM_HEADER_OPTIONSF_TIMEDISCONTINUITY | Há uma descontinuidade no fluxo de dados após esse pacote. Esse sinalizador pode ser usado para interfaces orientadas a posicionais para indicar o fim dos dados de fluxo. Nenhum buffer de dados real precisa ser anexado. |
| KSSTREAM_HEADER_OPTIONSF_TIMEVALID | Especifica que o membro PresentationTime dessa estrutura é válido. Indica que esse buffer tem um carimbo de data/hora válido associado a ele. |
| KSSTREAM_HEADER_OPTIONSF_TYPECHANGED | Significa que o formato de dados desse fluxo foi alterado. Se esse sinalizador for definido, o membro Data conterá uma estrutura KSDATAFORMAT que contém o novo formato. Esse sinalizador é válido apenas para fluxos que negociaram anteriormente a alteração de tipo dinâmico. Para uma operação de gravação, inclua o novo formato de dados no lugar de um exemplo de mídia. Se o tamanho da extensão específica da mídia for modificado, esse cabeçalho deverá ser o último cabeçalho em uma lista de cabeçalhos para a solicitação de fluxo fornecida. Durante uma solicitação de leitura, qualquer E/S adicional permanece pendente até que o novo formato seja recuperado por meio de KSPROPERTY_CONNECTION_DATAFORMAT. Para uma operação de gravação, o cabeçalho não deve ser estendido e deve ser o único cabeçalho na operação de gravação. |
| KSSTREAM_HEADER_OPTIONSF_VRAM_DATA_TRANSFER | Especifica que o membro Data do cabeçalho de fluxo aponta para uma estrutura do tipo VRAM_SURFACE_INFO. O módulo de proxy KS fornecido pelo sistema define esse sinalizador para indicar que ele está capturando diretamente na VRAM. |
| KSSTREAM_HEADER_OPTIONSF_BUFFEREDTRANSFER | Especifica que o membro Data do KSSTREAM_HEADER contém uma cópia do modo kernel do buffer original. O Ksproxy define esse sinalizador para pequenas transferências de dados durante a captura do WVDDM (Modelo de Driver de Exibição do Windows Vista). Se esse sinalizador não estiver definido, o KS usará E/S direta para o buffer de dados . |
Reserved
Reservado para uso interno.
Comentários
Essa estrutura pode ser seguida na memória por informações adicionais específicas para o tipo de dados no pacote de dados.
O tempo de apresentação normalmente é em unidades de 100 nanossegundos; no entanto, o formato padrão desta vez é baseado no formato de dados. Você pode normalizar o tempo de apresentação usando como um dimensionamento fracionário da KSSTREAM_HEADER. PresentationTime.Numerator dividido pela KSSTREAM_HEADER. PresentationTime.Denominator .
Uma conversão deve usar o numerador primeiro, depois o denominador, para reduzir os erros de arredondamento. Por exemplo, um fluxo de áudio pode apresentar a hora atual como um deslocamento de bytes no fluxo de dados:
#define BITS_PER_BYTE8
#define NANOSECONDS10000000
StreamHdr->PresentationTime.Numerator = BITS_PER_BYTE * NANOSECONDS;
StreamHdr->PresentationTime.Denominator = BitsPerSample * Channels * Frequency;
StreamHdr->PresentationTime.Time = ByteOffset;
StreamHdr->Duration = ByteLength;
Em um IOCTL_KS_READ_STREAM, partes do cabeçalho de fluxo são preenchidas pela chamada. Cada KSSTREAM_HEADER. O elemento DataUsed contém o número real de bytes lidos, que é menor ou igual a cada KSSTREAM_HEADER. FrameExtent. O elemento pIrp-IoStatus.Information> contém o tamanho total dos dados de cabeçalho a serem retornados, que é pelo menos um sizeof(KSSTREAM_HEADER).
Em um IOCTL_KS_WRITE_STREAM, os elementos membro devem ser inicializados e cada KSSTREAM_HEADER. O elemento DataUsed contém o número de bytes a serem gravados. O número real de bytes totais gravados é retornado em pIrp-IoStatus.Information>. Isso é menor ou igual ao total de todos os KSSTREAM_HEADER. Elementos DataUsed nos cabeçalhos.
Se você estiver usando a interface IKsReferenceClock para obter carimbos de data/hora a serem colocados no membro PresentationTime do KSSTREAM_HEADER, consulte Relógios AVStream para obter mais informações.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ks.h (inclua Ks.h) |