IDebugControl7::GetDebuggeeType2 方法 (dbgeng.h)
GetDebuggeeType2 方法描述目前目標的本質。
語法
HRESULT GetDebuggeeType2(
[in] ULONG Flags,
[out] PULONG Class,
[out] PULONG Qualifier
);
參數
[in] Flags
採用單一旗標DEBUG_EXEC_FLAGS_NONBLOCK,指出函式 GetDebuggeeType2 是否應該擁有引擎關鍵區段物件 (g_EngineLock) ,再尋找偵錯類型。
如果旗標存在,則函式會嘗試擁有重要區段。 如果失敗,它會繼續,而不會封鎖呼叫端線程。
如果未傳入旗標,則函式會等候引擎關鍵區段可供使用,再繼續進行。
[out] Class
接收目前目標的類別。 它將會設定為下表中的其中一個值。
值 | Description |
---|---|
DEBUG_CLASS_UNINITIALIZED | 沒有目前的目標。 |
DEBUG_CLASS_KERNEL | 目前的目標是核心模式目標。 |
DEBUG_CLASS_USER_WINDOWS | 目前的目標是使用者模式目標。 |
[out] Qualifier
提供有關目標類型的詳細資訊。 其解譯取決於 Class 的值。 當類別DEBUG_CLASS_UNINITIALIZED時, 限定符 會傳回零。 下列值適用於核心模式目標。
值 | Description |
---|---|
DEBUG_KERNEL_CONNECTION | 目前的目標是使用 COM 埠、1394 總線或命名管道) 的標準 (方式來偵錯即時核心。 |
DEBUG_KERNEL_LOCAL | 目前的目標是本機核心。 |
DEBUG_KERNEL_EXDI_DRIVER | 目前的目標是使用 eXDI 驅動程式連線的即時核心。 |
DEBUG_KERNEL_SMALL_DUMP | 目前的目標是核心模式的 Small Memory Dump 檔案。 |
DEBUG_KERNEL_DUMP | 目前的目標是核心模式的核心記憶體傾印檔案。 |
DEBUG_KERNEL_FULL_DUMP | 目前的目標是核心模式的完整記憶體傾印檔案。 |
下列值適用於使用者模式目標。
值 | Description |
---|---|
DEBUG_USER_WINDOWS_PROCESS | 目前的目標是與 調試程式引擎位於同一部計算機上的使用者模式進程。 |
DEBUG_USER_WINDOWS_PROCESS_SERVER | 目前的目標是使用進程伺服器連線的使用者模式進程。 |
DEBUG_USER_WINDOWS_SMALL_DUMP | 目前的目標是使用者模式 Minidump 檔案。 |
DEBUG_USER_WINDOWS_DUMP | 目前的目標為完整 User-Mode 傾印檔案。 |
傳回值
這個方法不會傳回值。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dbgeng.h |