Metodo IMFAsyncCallback::GetParameters (mfobjects.h)

Articolo
02/28/2024

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

Condividi tramite