Método IMiniportWaveCíclicoStream::GetPosition (portcls.h)

El método GetPosition obtiene la posición actual de la secuencia.

Sintaxis

NTSTATUS GetPosition(
  [out] PULONG Position
);

Parámetros

[out] Position

Puntero de salida para el valor de posición. Este parámetro apunta a una variable asignada por el autor de la llamada en la que el método escribe la posición de bytes actual de la secuencia.

Valor devuelto

GetPosition devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.

Observaciones

GetPosition informa de la posición de reproducción o registro actual de la secuencia. La posición se expresa como un desplazamiento de bytes desde el principio del búfer DMA y representa la mejor estimación del controlador de miniporte de la posición de bytes de los datos actualmente en la DAC o ADC.

La posición es cero inmediatamente después de la inicialización de la secuencia. Una transición al estado de KSSTATE_STOP (vea KSSTATE) restablece la posición a cero. Cuando la secuencia se detiene mediante una transición de KSSTATE_RUN a KSSTATE_PAUSE o KSSTATE_ACQUIRE, la posición se bloquea. Descongela cuando la secuencia pasa de KSSTATE_PAUSE o KSSTATE_ACQUIRE a KSSTATE_RUN.

GetPosition especifica la posición como desplazamiento en el búfer cíclico. Cuando la posición alcanza el final del búfer cíclico, se ajusta alrededor del principio del búfer. Por lo tanto, la posición nunca supera el tamaño del búfer.

Tenga en cuenta que el valor de desplazamiento recuperado por una llamada GetPosition es uno de los siguientes:

• Para una secuencia de representación, el método GetPosition recupera la posición de reproducción, que es el desplazamiento de bytes de la muestra que se está reproduciendo actualmente a través de la DAC y que se transmite a través del conector del altavoz.
• Para una secuencia de captura, el método GetPosition recupera la posición del registro, que es el desplazamiento de bytes de la muestra más reciente que se va a recibir a través del conector de micrófono y capturado por el ADC.

No es el desplazamiento del ejemplo que el motor DMA del dispositivo de audio está leyendo o escribiendo en el búfer de audio.

Algunos hardware de audio contienen un registro de posición para realizar un seguimiento del desplazamiento de bytes de la muestra actualmente en cada DAC o ADC, en cuyo caso el método GetPosition simplemente recupera el contenido del registro de posición para la secuencia adecuada. Otro hardware de audio solo puede proporcionar el controlador con punteros DMA en los búferes de audio, en cuyo caso el método GetPosition debe proporcionar una mejor estimación del desplazamiento de bytes en la DAC o ADC en función de la posición DMA actual y los retrasos de almacenamiento en búfer internos del dispositivo.

El hardware de audio que almacena internamente en búfer una parte de una secuencia de reproducción o captura podría dificultar la lectura de una posición precisa. En este caso, el controlador debe calcular la posición actual lo más precisa posible. Por ejemplo, si un dispositivo de audio captura previamente la secuencia de reproducción en un búfer interno, es posible que el controlador tenga en cuenta tanto el tamaño del búfer como la información de tiempo para calcular correctamente la posición de reproducción.

El controlador de puerto WaveCíclico implementa un controlador de propiedades para KSPROPERTY_AUDIO_POSITION. Este controlador de propiedades llama al método GetPosition para obtener la posición de reproducción o registro actual del controlador de miniport. Para obtener más información, vea propiedad De posición de audio.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	portcls.h (incluya Portcls.h)
irQL	<=DISPATCH_LEVEL

Consulte también

IMiniportWaveStreamStream

KSPROPERTY_AUDIO_POSITION

KSSTATE