Metodo IMFAsyncCallback::GetParameters (mfobjects.h)

  • Articolo

Fornisce informazioni di configurazione al thread di invio per un callback.

Sintassi

HRESULT GetParameters(
  [out] DWORD *pdwFlags,
  [out] DWORD *pdwQueue
);

Parametri

[out] pdwFlags

Riceve un flag che indica il comportamento del metodo FMAsyncCallback dell'oggetto callback::Invoke . I valori seguenti sono definiti. Il valore predefinito è zero.

Valore Significato
Zero
 Il callback non richiede molto tempo per completare, ma non ha restrizioni specifiche sul sistema che chiama. Il callback richiede in genere meno di 30 millisecondi per completare.
MFASYNC_FAST_IO_PROCESSING_CALLBACK
 Il callback esegue un'elaborazione molto minima. Il completamento richiede meno di 1 millisecondo.

Il callback deve essere richiamato da una delle code di lavoro seguenti:

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_SIGNAL_CALLBACK
 Implica MFASYNC_FAST_IO_PROCESSING_CALLBACK, con la restrizione aggiuntiva che il callback non esegue alcuna elaborazione (meno di 50 microsecondi) e l'unica chiamata di sistema eseguita è SetEvent.

Il callback deve essere richiamato da una delle code di lavoro seguenti:

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_BLOCKING_CALLBACK
 Blocco del callback.
MFASYNC_REPLY_CALLBACK
 Callback di risposta.

[out] pdwQueue

Riceve l'identificatore della coda di lavoro in cui viene inviato il callback.

Questo valore può specificare una delle code di lavoro standard di Media Foundation o una coda di lavoro creata dall'applicazione. Per l'elenco delle code di lavoro standard di Media Foundation, vedere Identificatori della coda di lavoro. Per creare una nuova coda di lavoro, chiamare MFAllocateWorkQueue. Il valore predefinito è MFASYNC_CALLBACK_QUEUE_STANDARD.

Se la coda di lavoro non è compatibile con il valore restituito in pdwFlags, la piattaforma Media Foundation restituisce MF_E_INVALID_WORKQUEUE quando tenta di inviare il callback. Vedere MFPutWorkItem.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
 Il metodo è riuscito.
E_NOTIMPL
 Non implementato. Si supponga il comportamento predefinito.

Commenti

Il metodo GetParameters restituisce informazioni sul callback in modo che il thread di invio possa ottimizzare il processo usato per richiamare il callback.

Se il metodo restituisce un valore diverso da zero nel parametro pdwFlags , il metodo Invoke deve soddisfare i requisiti descritti qui. In caso contrario, il callback potrebbe ritardare la pipeline.

Se si desiderano valori predefiniti per entrambi i parametri, restituire E_NOTIMPL. I valori predefiniti vengono specificati nelle descrizioni dei parametri in questa pagina.

Questa interfaccia è disponibile nelle piattaforme seguenti se i componenti ridistribuibili di Windows Media Format 11 SDK sono installati:

  • Windows XP con Service Pack 2 (SP2) e versioni successive.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione mfobjects.h (include Mfidl.h)
Libreria Mfuuid.lib

Vedi anche

Metodi di callback asincroni

IMFAsyncCallback

Code di lavoro