estructura KSAUDIO_PACKETSIZE_CONSTRAINTS2 (ksmedia.h)

  • Artículo

La estructura KSAUDIO_PACKETSIZE_CONSTRAINTS2 describe las restricciones de hardware físico. Incluye una matriz de 0 o más estructuras KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT que describen restricciones específicas de cualquier modo de procesamiento de señal. El controlador establece esta propiedad antes de llamar a PcRegisterSubdevice o habilitar su interfaz de filtro KS para sus patillas de streaming.

Sintaxis

typedef struct _KSAUDIO_PACKETSIZE_CONSTRAINTS2 {
  ULONG                                        MinPacketPeriodInHns;
  ULONG                                        PacketSizeFileAlignment;
  ULONG                                        MaxPacketSizeInBytes;
  ULONG                                        NumProcessingModeConstraints;
  KSAUDIO_PACKETSIZE_PROCESSINGMODE_CONSTRAINT ProcessingModeConstraints[ANYSIZE_ARRAY];
} KSAUDIO_PACKETSIZE_CONSTRAINTS2;

Miembros

MinPacketPeriodInHns

El período de procesamiento mínimo absoluto admitido por el controlador expresado en cientos de unidades de nanosegundos (HNS). Este valor puede ser 0 si el controlador no tiene ningún período de procesamiento mínimo específico.

PacketSizeFileAlignment

Requisito de alineación de tamaño de bytes. Use uno de estos valores de alineación de archivos definidos:

FILE_BYTE_ALIGNMENT

FILE_WORD_ALIGNMENT

FILE_LONG_ALIGNMENT

FILE_QUAD_ALIGNMENT

FILE_OCTA_ALIGNMENT

FILE_32_BYTE_ALIGNMENT

FILE_64_BYTE_ALIGNMENT

FILE_128_BYTE_ALIGNMENT

FILE_256_BYTE_ALIGNMENT

FILE_512_BYTE_ALIGNMENT

MaxPacketSizeInBytes

Tamaño máximo absoluto de paquete admitido por el controlador en bytes. Esto puede ser cero si el controlador no tiene ningún tamaño máximo de paquete específico. Este tamaño debe ser lo suficientemente grande como para admitir el búfer de 10 ms de cualquier formato admitido por la patilla. Este tamaño también debe ser mayor o igual que las restricciones MinPacketSize.

NumProcessingModeConstraints

Número de restricciones adicionales para modos de procesamiento específicos. Este valor puede ser 0.

ProcessingModeConstraints[ANYSIZE_ARRAY]

Matriz de 0 o más restricciones de modo de procesamiento.

Comentarios

El controlador establece esta estructura de datos de longitud variable como el valor de la propiedad DEVPKEY_KsAudio_PacketSize_Constraints2 en la interfaz PnP del filtro KS que tiene las patillas de streaming con las restricciones.

En el caso de los controladores waveRT, esta estructura de datos describe las restricciones de un paquete WaveRT. Varios paquetes WaveRT (normalmente 2) se concatenan para formar el búfer waveRT.

La estructura KSAUDIO_PACKETSIZE_CONSTRAINTS2 está disponible a partir de Windows 10, versión 1607.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Encabezado ksmedia.h