Estructura CAPTUREPARMS (vfw.h)

Artículo
08/27/2023

La estructura CAPTUREPARMS contiene parámetros que controlan el proceso de captura de vídeo de streaming. Esta estructura se usa para obtener y establecer parámetros que afectan a la velocidad de captura, el número de búferes que se usarán durante la captura y cómo se finaliza la captura.

Sintaxis

typedef struct tagCaptureParms {
  DWORD dwRequestMicroSecPerFrame;
  BOOL  fMakeUserHitOKToCapture;
  UINT  wPercentDropForError;
  BOOL  fYield;
  DWORD dwIndexSize;
  UINT  wChunkGranularity;
  BOOL  fUsingDOSMemory;
  UINT  wNumVideoRequested;
  BOOL  fCaptureAudio;
  UINT  wNumAudioRequested;
  UINT  vKeyAbort;
  BOOL  fAbortLeftMouse;
  BOOL  fAbortRightMouse;
  BOOL  fLimitEnabled;
  UINT  wTimeLimit;
  BOOL  fMCIControl;
  BOOL  fStepMCIDevice;
  DWORD dwMCIStartTime;
  DWORD dwMCIStopTime;
  BOOL  fStepCaptureAt2x;
  UINT  wStepCaptureAverageFrames;
  DWORD dwAudioBufferSize;
  BOOL  fDisableWriteCache;
  UINT  AVStreamMaster;
} CAPTUREPARMS, *PCAPTUREPARMS, *LPCAPTUREPARMS;

Miembros

dwRequestMicroSecPerFrame

Velocidad de fotogramas solicitada, en microsegundos. El valor predeterminado es 66667, que corresponde a 15 fotogramas por segundo.

fMakeUserHitOKToCapture

Marca de captura iniciada por el usuario. Si este miembro es TRUE, AVICap muestra un cuadro de diálogo que pide al usuario que inicie la captura. El valor predeterminado es FALSE.

wPercentDropForError

Porcentaje máximo permitido de fotogramas quitados durante la captura. Los valores pueden oscilar entre 0 y 100. El valor predeterminado es 10.

fYield

Marca de rendimiento. Si este miembro es TRUE, la ventana de captura genera un subproceso en segundo plano independiente para realizar la captura de pasos y streaming. El valor predeterminado es FALSE.

Las aplicaciones que establecen esta marca deben controlar posibles problemas de reentrada porque los controles de la aplicación no están deshabilitados mientras la captura está en curso.

dwIndexSize

Número máximo de entradas de índice en un archivo AVI. Los valores van de 1800 a 324 000. Si se establece en 0, se usa un valor predeterminado de 34 952 (32 000 fotogramas más un número proporcional de búferes de audio).

Cada fotograma de vídeo o búfer de datos de audio de forma de onda usa una entrada de índice. El valor de esta entrada establece un límite para el número de fotogramas o búferes de audio que se pueden capturar.

wChunkGranularity

Tamaño de bloque lógico, en bytes, de un archivo AVI. El valor 0 indica que el tamaño del sector actual se usa como granularidad.

fUsingDOSMemory

No se usa en aplicaciones Win32.

wNumVideoRequested

Número máximo de búferes de vídeo que se van a asignar. El área de memoria para colocar los búferes se especifica con fUsingDOSMemory. El número real de búferes asignados podría ser menor si la memoria no está disponible.

fCaptureAudio

Captura de la marca de audio. Si este miembro es TRUE, el audio se captura durante la captura de streaming. Este es el valor predeterminado si está instalado el hardware de audio.

wNumAudioRequested

Número máximo de búferes de audio que se van a asignar. El número máximo de búferes es 10.

vKeyAbort

Código de clave virtual que se usa para finalizar la captura de streaming. El valor predeterminado es VK_ESCAPE. Debe llamar a la función RegisterHotKey antes de especificar una pulsación de tecla que pueda anular una sesión de captura.

Puede combinar códigos de teclas que incluyen pulsaciones de teclas CTRL y MAYÚS mediante el operador LÓGICO OR con los códigos de teclas para CTRL (0x8000) y MAYÚS (0x4000).

fAbortLeftMouse

Anular marca para el botón izquierdo del mouse. Si este miembro es TRUE, la captura de streaming se detiene si se presiona el botón izquierdo del mouse. El valor predeterminado es TRUE.

fAbortRightMouse

Anular marca para el botón derecho del mouse. Si este miembro es TRUE, la captura de streaming se detiene si se presiona el botón derecho del mouse. El valor predeterminado es TRUE.

fLimitEnabled

Marca habilitada del límite de tiempo. Si este miembro es TRUE, la captura de streaming se detiene después de que haya transcurrido el número de segundos en wTimeLimit . El valor predeterminado es FALSE.

wTimeLimit

Límite de tiempo para la captura, en segundos. Este parámetro solo se usa si fLimitEnabled es TRUE.

fMCIControl

Marca de captura de dispositivos MCI. Si este miembro es TRUE, AVICap controla un origen de vídeo compatible con MCI durante la captura de streaming. Las fuentes de vídeo compatibles con MCI incluyen VCR y laserdiscs.

fStepMCIDevice

Marca de captura de pasos de dispositivo MCI. Si este miembro es TRUE, se habilita la captura de pasos mediante un dispositivo MCI como origen de vídeo. Si es FALSE, se habilita la captura en tiempo real mediante un dispositivo MCI. (Si fMCIControl es FALSE, se omite este miembro).

dwMCIStartTime

Posición inicial, en milisegundos, del dispositivo MCI para la secuencia de captura. (Si fMCIControl es FALSE, se omite este miembro).

dwMCIStopTime

Posición de detención, en milisegundos, del dispositivo MCI para la secuencia de captura. Cuando se alcanza esta posición en el contenido, la captura finaliza y el dispositivo MCI se detiene. (Si fMCIControl es FALSE, se omite este miembro).

fStepCaptureAt2x

Marca de captura de pasos de doble resolución. Si este miembro es TRUE, el hardware de captura captura dos veces la resolución especificada. (La resolución del alto y ancho se duplica).

Habilite esta opción si el hardware no admite el descifrado basado en hardware y está capturando en el formato RGB.

wStepCaptureAverageFrames

Número de veces que se muestrea un fotograma al crear un fotograma basado en la muestra media. Un valor típico para el número de promedios es 5.

dwAudioBufferSize

Tamaño del búfer de audio. Si se usa el valor predeterminado de cero, el tamaño de cada búfer será el máximo de 0,5 segundos de audio o 10 000 bytes.

fDisableWriteCache

No se usa en aplicaciones Win32.

AVStreamMaster

Indica si la secuencia de audio controla el reloj al escribir un archivo AVI. Si este miembro se establece en AVSTREAMMASTER_AUDIO, la secuencia de audio se considera la secuencia maestra y la duración de la secuencia de vídeo se ve forzada a coincidir con la duración del audio. Si este miembro se establece en AVSTREAMMASTER_NONE, las duraciones de las secuencias de audio y vídeo pueden diferir.

Comentarios

La macro WM_CAP_GET_SEQUENCE_SETUP message o capCaptureGetSetup se usa para recuperar los parámetros de captura actuales. La macro WM_CAP_SET_SEQUENCE_SETUP message o capCaptureSetSetup se usa para establecer los parámetros de captura.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	vfw.h