Funzione VideoPortWaitForSingleObject (video.h)

Articolo
02/26/2024

La funzione VideoPortWaitForSingleObject inserisce il thread corrente in uno stato di attesa fino a quando l'oggetto dispatch specificato non viene impostato sullo stato segnalato o (facoltativamente) fino al timeout dell'attesa.

Sintassi

VIDEOPORT_API VP_STATUS VideoPortWaitForSingleObject(
  [in] IN PVOID          HwDeviceExtension,
  [in] IN PVOID          Object,
  [in] IN PLARGE_INTEGER Timeout
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] Object

Puntatore all'oggetto evento.

[in] Timeout

(Facoltativo) Puntatore a un valore di timeout che specifica l'ora assoluta o relativa in cui deve essere completata l'attesa. Un valore negativo specifica un intervallo di attesa relativo all'ora corrente. Il valore deve essere espresso in unità di 100 nanosecondi. I tempi di scadenza assoluti tengono traccia delle modifiche apportate all'ora di sistema; le ore di scadenza relative non sono interessate dalle modifiche apportate all'ora di sistema.

Valore restituito

VideoPortWaitForSingleObject restituisce uno dei valori seguenti:

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno dei parametri non è valido o la chiamata ha tentato di attendere un evento utente mappato.
NO_ERROR	L'oggetto evento specificato nel parametro pObject ha soddisfatto l'attesa.
WAIT_TIMEOUT	Si è verificato un timeout prima che l'oggetto evento sia stato impostato sullo stato segnalato. Questo valore può essere restituito quando non è possibile soddisfare immediatamente il set specificato di condizioni di attesa e Timeout è impostato su zero.

Commenti

Il driver miniport non deve tentare di attendere un evento utente mappato.

I chiamanti di VideoPortWaitForSingleObject devono essere in esecuzione in IRQL <= DISPATCH_LEVEL. In genere, il chiamante verrà eseguito in IRQL = PASSIVE_LEVEL e in un contesto di thread non arbiverso. Una chiamata a questa funzione durante l'esecuzione in IRQL = DISPATCH_LEVEL è valida se e solo se il chiamante specifica un valore di timeout pari a zero. Ovvero, un driver miniport non deve attendere un intervallo diverso da zero in IRQL = DISPATCH_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows XP e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	video.h (include Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	<= DISPATCH_LEVEL (vedere la sezione Osservazioni)

Condividi tramite