DXGK_TIMED_OPERATION_INTERFACE Struktur (dispmprt.h)
Die DXGK_TIMED_OPERATION_INTERFACE-Struktur enthält Zeiger auf Funktionen in der Timed Operation Interface, die vom Anzeigeporttreiber implementiert wird.
Syntax
typedef struct _DXGK_TIMED_OPERATION_INTERFACE {
USHORT Size;
USHORT Version;
PVOID Context;
PINTERFACE_REFERENCE InterfaceReference;
PINTERFACE_DEREFERENCE InterfaceDereference;
NTSTATUS((DXGK_TIMED_OPERATION *Op, const LARGE_INTEGER *Timeout,BOOLEAN OsHandled) * )TimedOperationStart;
NTSTATUS((DXGK_TIMED_OPERATION *Op,KPROCESSOR_MODE WaitMode,BOOLEAN Alertable, const LARGE_INTEGER *Interval) * )TimedOperationDelay;
NTSTATUS((DXGK_TIMED_OPERATION *Op,PVOID Object,KWAIT_REASON WaitReason,KPROCESSOR_MODE WaitMode,BOOLEAN Alertable, const LARGE_INTEGER *Timeout) * )TimedOperationWaitForSingleObject;
} DXGK_TIMED_OPERATION_INTERFACE, *PDXGK_TIMED_OPERATION_INTERFACE;
Angehörige
Size
Die Größe dieser Struktur in Byte.
Version
Die Versionsnummer der Timed Operation Interface. Versionsnummernkonstanten werden in Dispmprt.h- definiert (z. B. DXGK_TIMED_OPERATION_INTERFACE_VERSION_1).
Context
Ein Zeiger auf einen Kontext, der vom Anzeigeporttreiber bereitgestellt wird.
InterfaceReference
Ein Zeiger auf eine Schnittstellenverweisfunktion, die vom Anzeigeporttreiber implementiert wird.
InterfaceDereference
Ein Zeiger auf eine Schnittstellen-Ableitungsfunktion, die vom Anzeigeporttreiber implementiert wird.
TimedOperationStart
Die TimedOperationStart-Funktion startet oder startet einen timed-Vorgang neu.
Der Treiber sollte das Size Member der DXGK_TIMED_OPERATION Struktur voreingestellt haben, auf das der Parameter Op verweist, um die Größe (DXGK_TIMED_OPERATION) zu. Parameterbeschreibungen für TimedOperationStart folgen.
[out] Op ist ein Zeiger auf eine DXGK_TIMED_OPERATION Struktur, in der der zeitaufwendiger Vorgang zum Starten oder Neustart beschrieben wird.
[in] Timeout- ist ein Zeiger auf einen Timeoutwert in 100-Nanosekundeneinheiten, der die relative Zeit angibt, die für den abgeschlossenen zeitgesteuerten Vorgang zugewiesen wurde.
[in] OsHandled ist ein boolescher Wert, der angibt, ob das Betriebssystem die Timeoutbedingung behandelt. Ein Wert von TRUE gibt an, dass der Treiber keine vernünftige Möglichkeit hat, die Timeoutbedingung zu verarbeiten und das Betriebssystem die Timeoutbedingung zu verarbeiten; FALSE gibt an, dass der Treiber die Timeoutbedingung behandelt.
TimedOperationDelay
Die TimedOperationDelay--Funktion versetzt den aktuellen Thread in einen warnbaren oder nicht veränderlichen Wartezustand für ein bestimmtes Intervall im Hinblick auf das angegebene Timeout des Zeitüberschreitungsvorgangs. Parameterbeschreibungen für TimedOperationDelay folgen.
[in/out] Op ist ein Zeiger auf eine DXGK_TIMED_OPERATION Struktur, die den zeitverzögerten Vorgang beschreibt. Dieser Zeitgebervorgang wurde durch einen Aufruf der TimedOperationStart-Funktion gestartet.
[in] WaitMode ist ein KPROCESSOR_MODE typisierter Wert, der den Prozessormodus angibt, in dem der Treiber wartet. Der Wert kann entweder KernelMode- oder UserMode-sein. Treiber auf niedrigerer Ebene in einem Stapel sollten KernelMode-angeben.
[in] Warnungsfähige ist ein boolescher Wert, der angibt, ob die Wartezeit warnbar ist. Ein Wert von TRUE gibt an, dass die Wartezeit warnbar ist; FALSE gibt an, dass die Wartezeit nicht fähig ist. Treiber auf niedrigerer Ebene in einem Stapel sollten FALSE angeben.
[in] Interval ist ein Zeiger auf variable, der die relative Zeit in 100-Nanosekundeneinheiten für die Verzögerung enthält. Das Vorzeichen des Werts wird ignoriert.
TimedOperationWaitForSingleObject
Die TimedOperationWaitForSingleObject--Funktion versetzt den aktuellen Thread in einen Wartezustand, bis das angegebene Dispatcherobjekt auf einen signalisierten Zustand festgelegt ist oder optional bis die Wartezeit oder bis das Timeout des angegebenen zeitgesteuerten Vorgangs abläuft. Parameterbeschreibungen für TimedOperationWaitForSingleObject folgen.
[in] Op ist ein Zeiger auf eine DXGK_TIMED_OPERATION Struktur, die den Zeitvorgang beschreibt, der in einen Wartezustand versetzt werden soll. Dieser Zeitgebervorgang wurde durch einen Aufruf der TimedOperationStart-Funktion gestartet.
Object ist ein Zeiger auf ein initialisiertes Dispatcherobjekt, für das der Aufrufer den Speicher bereitstellt. Das Dispatcherobjekt kann ein Ereignis, ein Mutex, ein Semaphor, ein Thread oder ein Timer sein.
WaitReason ist ein KWAIT_REASON typisierter Wert, der den Grund für die Wartezeit angibt. Ein Treiber sollte diesen Wert auf Executive festlegen oder, wenn der Treiber im Auftrag eines Benutzers arbeitet und im Kontext eines Benutzerthreads ausgeführt wird, auf UserRequest.
WaitMode ist ein KPROCESSOR_MODE typisierter Wert, der den Prozessormodus angibt, in dem der Treiber wartet. Der Wert kann entweder KernelMode- oder UserMode-sein. Untergeordnete und Zwischentreiber sollten KernelMode-angeben. Wenn das Objekt, auf das der Parameter Object verweist, ein Mutex ist, muss der Aufrufer KernelMode-angeben.
Warnungsfähige ist ein boolescher Wert, der angibt, ob die Wartezeit warnbar ist. Ein Wert von TRUE gibt an, dass die Wartezeit warnbar ist; FALSE gibt an, dass die Wartezeit nicht fähig ist.
Timeout- ist ein Zeiger auf Variable, der die relative Zeit in 100 Nanosekundeneinheiten enthält, damit die Wartezeit abgeschlossen ist. Das Vorzeichen des Werts wird ignoriert.
Bemerkungen
Der Miniporttreiber für die Anzeige stellt die Size und Version Member dieser Struktur bereit und ruft dann DxgkCbQueryServicesauf, der die verbleibenden Elemente dieser Struktur ausfüllt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Header- | dispmprt.h (include Dispmprt.h) |