RTL_QUERY_REGISTRY_ROUTINE回呼函式 (wdm.h)

  • 發行項

QueryRoutine 例程提供先前呼叫 RtlQueryRegistryValues 例程中所要求的登錄值相關信息。

語法

RTL_QUERY_REGISTRY_ROUTINE RtlQueryRegistryRoutine;

NTSTATUS RtlQueryRegistryRoutine(
  [in]           PWSTR ValueName,
  [in]           ULONG ValueType,
  [in]           PVOID ValueData,
  [in]           ULONG ValueLength,
  [in, optional] PVOID Context,
  [in, optional] PVOID EntryContext
)
{...}

參數

[in] ValueName

指定與要求之登錄值相關聯的登錄機碼。 此參數是包含索引鍵之 Null 終止 Unicode 字串的指標。

[in] ValueType

指定以指定登錄機碼儲存的登錄值類型。 如需詳細資訊，請參閱 KEY_VALUE_BASIC_INFORMATION 中的 Type 參數定義。

[in] ValueData

與指定登錄機碼相關聯的數據值指標。 驅動程式必須將此值視為唯讀。 如需 ValueData 指向之實值數據類型的詳細資訊，請參閱 KEY_VALUE_BASIC_INFORMATION 中的 Type 參數定義。

[in] ValueLength

指定 ValueData 所指向值的長度，以位元組為單位。

[in, optional] Context

指定上述對 RtlQueryRegistryValues 呼叫中指定的驅動程式內容參數值。

[in, optional] EntryContext

指定 QueryTable 陣列專案中的 EntryContext 值，該數位元素是先前呼叫 RtlQueryRegistryValues 中指定的驅動程式。

傳回值

如果呼叫成功，QueryRoutine 會傳回STATUS_SUCCESS。 否則，它會傳回適當的錯誤狀態代碼。 僅使用 Ntstatus.h 頭檔中定義的狀態代碼。

備註

核心模式驅動程式會實作 QueryRoutine 例程。 RtlQueryRegistryValues 例程會呼叫此例程。

若要取得一或多個登錄值的相關信息，驅動程式會呼叫 RtlQueryRegistryValues ，並將指標當做輸入參數傳遞至 RTL_QUERY_REGISTRY_TABLE 結構的數位。 此陣列中的每個結構都包含驅動程序實作 QueryRoutine 例程的指標，以及特定登錄值相關信息的要求。 針對陣列中的每個結構， RtlQueryRegistryValues 會呼叫指定的 QueryRoutine 例程，並傳遞至此例程一組參數，其中包含所要求登錄值的相關信息。

如需 RTL_QUERY_REGISTRY_TABLE 結構的詳細資訊，請參閱 RtlQueryRegistryValues。

範例

若要定義 QueryRoutine 回呼例程，您必須先提供函式宣告，以識別您要定義的回呼例程類型。 Windows 提供一組驅動程式的回呼函式類型。 使用回呼函式類型宣告函式有助於 驅動程式的程式代碼分析、 靜態驅動程式驗證器 (SDV) ，以及其他驗證工具會尋找錯誤，而且這是撰寫 Windows 操作系統驅動程式的需求。

例如，若要定義名為MyQueryRoutine的 QueryRoutine 回呼例程，請使用 RTL_QUERY_REGISTRY_ROUTINE 類型，如下列程式碼範例所示：

RTL_QUERY_REGISTRY_ROUTINE MyQueryRoutine;

然後，實作回呼例程，如下所示：

_Use_decl_annotations_
NTSTATUS
  MyQueryRoutine(
    PWSTR ValueName,
    ULONG ValueType,
    PVOID ValueData,
    ULONG ValueLength,
    PVOID Context,
    PVOID EntryContext
    )
  {
      // Function body
  }

RTL_QUERY_REGISTRY_ROUTINE函式類型定義於 Wdm.h 頭檔中。 若要在執行程式代碼分析工具時更精確地識別錯誤，請務必將 _Use_decl_annotations_ 註釋新增至函式定義。 批 _Use_decl_annotations_ 注可確保在頭檔中套用至RTL_QUERY_REGISTRY_ROUTINE函式類型的批注。 如需函式宣告需求的詳細資訊，請參閱 使用WDM驅動程式的函式角色類型來宣告函式。 如需 的相關信息 _Use_decl_annotations_，請參閱 標註函式行為。

規格需求

需求 值
目標平台 桌面
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
IRQL 在 PASSIVE_LEVEL呼叫。

另請參閱

KEY_VALUE_BASIC_INFORMATION

RtlQueryRegistryValues