estrutura KSPROPERTY_TUNER_SCAN_CAPS_S (ksmedia.h)

Artigo
02/29/2024

A estrutura KSPROPERTY_TUNER_SCAN_CAPS_S descreve os recursos de verificação de hardware de um dispositivo de ajuste.

Sintaxe

typedef struct {
  KSPROPERTY Property;
  BOOL       fSupportsHardwareAssistedScanning;
  ULONG      SupportedBroadcastStandards;
  PVOID      GUIDBucket;
  ULONG      lengthofBucket;
} KSPROPERTY_TUNER_SCAN_CAPS_S, *PKSPROPERTY_TUNER_SCAN_CAPS_S;

Membros

Property

Especifica uma estrutura KSPROPERTY inicializada que descreve o conjunto de propriedades, a ID da propriedade e o tipo de solicitação.

fSupportsHardwareAssistedScanning

Um valor booliano que indica se o driver ou firmware para um sintonizador dá suporte a operações de verificação assistidas por hardware. TRUE indica que o driver ou firmware para um sintonizador dá suporte a operações de verificação assistidas por hardware. FALSE indica que o driver ou firmware não dá suporte a operações de verificação assistidas por hardware.

SupportedBroadcastStandards

O número de tipos padrão de vídeo de transmissão que o dispositivo de ajuste pode dar suporte. Um sintonizador híbrido pode dar suporte a vários tipos.

GUIDBucket

Uma matriz de GUIDs para os tipos de rede compatíveis com o dispositivo de ajuste.

Com base no número com suporte em SupportedBroadcastStandards que é retornado na chamada inicial para a propriedade KSPROPERTY_TUNER_SCAN_CAPS , o filtro de sintonizador analógico ou digital aloca uma matriz de GUIDs. O driver usa esse buffer de usuário alocado para retornar todos os GUIDs com suporte na próxima chamada para KSPROPERTY_TUNER_SCAN_CAPS. O driver deve chamar a função ProbeForWrite para validar esse buffer de usuário e deve garantir que o comprimento do buffer seja válido. Embora seja improvável, se o driver acessar esse buffer em um thread arbitrário, ele deverá mapear o buffer para o espaço do kernel. Atualmente, os recursos de verificação são definidos para dar suporte ao padrão analógico. Se o driver der suporte a analógico e o aplicativo pretende iniciar uma sessão de verificação para analógico, os recursos correspondentes serão definidos pela propriedade KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS . Outros recursos de verificação para dar suporte a outros padrões de difusão (por exemplo, DVB-S) ainda não têm suporte.

lengthofBucket

O número de GUIDs na matriz GUIDBucket .