Método IMFTrackedSample::SetAllocator (mfidl.h)

  • Artículo

Establece el propietario del ejemplo.

Sintaxis

HRESULT SetAllocator(
  [in] IMFAsyncCallback *pSampleAllocator,
  [in] IUnknown         *pUnkState
);

Parámetros

[in] pSampleAllocator

Puntero a la interfaz IMFAsyncCallback de un objeto de devolución de llamada. El autor de la llamada debe implementar esta interfaz.

[in] pUnkState

Puntero a la interfaz IUnknown de un objeto de estado, definido por el autor de la llamada. Este parámetro puede ser NULL. Puede usar este objeto para contener información de estado. El objeto se devuelve al autor de la llamada cuando se invoca la devolución de llamada.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_NOTACCEPTING
 El propietario ya estaba establecido. No se puede llamar a este método dos veces en el ejemplo.

Comentarios

Cuando se llama a este método, el ejemplo contiene un recuento de referencias adicional en sí mismo. Cuando todos los demás objetos liberan sus recuentos de referencia en el ejemplo, el ejemplo invoca el método de devolución de llamada pSampleAllocator . Para obtener un puntero al ejemplo, llame a IMFAsyncResult::GetObject en el objeto de resultado asincrónico dado al método IMFAsyncCallback::Invoke de la devolución de llamada.

Una vez invocada la devolución de llamada, el ejemplo borra la devolución de llamada. Para restablecer la devolución de llamada, debe volver a llamar a SetAllocator .

Es seguro pasar el puntero de interfaz IMFSample del ejemplo como el objeto de estado (pUnkState) para la devolución de llamada. Si pUnkState apunta al ejemplo, el método SetAllocator tiene en cuenta el recuento de referencias adicional en pUnkState.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfidl.h
Library Strmiids.lib

Consulte también

IMFTrackedSample