DXGK_TIMED_OPERATION_INTERFACE結構(dispmprt.h)
DXGK_TIMED_OPERATION_INTERFACE 結構包含 Timed 作業介面中函式的指標,此介面是由顯示埠驅動程式實作。
語法
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;
成員
Size
這個 結構的大小,以位元組為單位。
Version
Timed 作業介面的版本號碼。 版本號碼常數定義於 Dispmprt.h 中(例如,DXGK_TIMED_OPERATION_INTERFACE_VERSION_1)。
Context
顯示埠驅動程式所提供之內容的指標。
InterfaceReference
由顯示埠驅動程序實作之介面參考函式的指標。
InterfaceDereference
顯示埠驅動程式所實作之介面取值函式的指標。
TimedOperationStart
TimedOperationStart 函式會啟動或重新啟動計時作業。
驅動程式應預設 SizeDXGK_TIMED_OPERATION 結構的成員,Op 參數所指向 sizeof(DXGK_TIMED_OPERATION)。 TimedOperationStart 的參數描述 如下。
[out] Op 是描述開始或重新啟動之時間作業之 DXGK_TIMED_OPERATION 結構的指標。
[in] 逾時 是逾時值的指標,以 100 奈秒為單位,指定指派給逾時作業完成的相對時間。
[in] OsHandled 是布爾值,指定作系統是否處理逾時條件。 TRUE 值表示驅動程序沒有任何合理的方法來處理逾時條件,並讓作系統處理逾時條件:FALSE 表示驅動程式會處理逾時條件。
TimedOperationDelay
TimedOperationDelay 函式會將目前線程置於指定逾時作業逾時時的相關指定間隔的可警示或不可變更的等候狀態。TimedOperationDelay 的參數描述如下。
[in/out] Op 是描述延遲時間作業之 DXGK_TIMED_OPERATION 結構的指標。 這次定時作業是由呼叫 timedOperationStart 函式所啟動。
[in] WaitMode 是一個KPROCESSOR_MODE類型的值,指定驅動程式等候的處理器模式。 此值可以是 KernelMode 或 UserMode。 堆疊中的較低層級驅動程式應該指定 KernelMode。
[in] Alertable 是布爾值,指定等候是否可警示。 TRUE 值表示等候可警示;FALSE 表示等候無法回應。 堆疊中的較低層級驅動程式應指定 FALSE。
[in] Interval 是變數的指標,其中包含延遲的 100 奈秒單位的相對時間。 會忽略值的正負號。
TimedOperationWaitForSingleObject
TimedOperationWaitForSingleObject 函式會將目前的線程置於等候狀態,直到指定的發送器物件設定為訊號狀態,或選擇性地等到等候逾時或直到指定逾時作業逾時為止。 TimedOperationWaitForSingleObject 的參數描述如下。
[in] Op 是描述要放入等候狀態之計時作業之 DXGK_TIMED_OPERATION 結構的指標。 這次定時作業是由呼叫 timedOperationStart 函式所啟動。
Object 是呼叫端提供記憶體之初始化發送器物件的指標。 發送器物件可以是事件、Mutex、號誌、線程或定時器。
WaitReason 是指定等候原因的KWAIT_REASON型別值。 驅動程式應將此值設定為 Executive,或者,如果驅動程式代表使用者執行工作,並在使用者線程的內容中執行,則為 UserRequest。
WaitMode 是KPROCESSOR_MODE類型的值,指定驅動程式等候的處理器模式。 此值可以是 KernelMode 或 UserMode。 最低層級和中繼驅動程式應該指定 KernelMode。 如果 Object 參數所指向的物件是 mutex,呼叫端必須指定 KernelMode。
Alertable 是布爾值,指定等候是否可警示。 TRUE 值表示等候可警示;FALSE 表示等候無法回應。
Timeout 是變數的指標,其中包含 100 奈秒單位的相對時間,等候完成。 會忽略值的正負號。
言論
顯示迷你埠驅動程式會提供 Size 和 Version 成員,然後呼叫 DxgkCbQueryServices,以填入這個結構的其餘成員。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
標頭 | dispmprt.h (包括 Dispmprt.h) |