VerifierEnumerateResource 関数 (avrfsdk.h)

[アーティクル]
03/05/2024

デバッグおよびサポートツールで使用するオペレーティングシステムリソースを列挙します。

構文

ULONG VerifierEnumerateResource(
  HANDLE                           Process,
  ULONG                            Flags,
  ULONG                            ResourceType,
  AVRF_RESOURCE_ENUMERATE_CALLBACK ResourceCallback,
  PVOID                            EnumerationContext
);

パラメーター

Process

リソースが列挙されているプロセスへのハンドル。

ResourceType パラメーターが AvrfResrouceHeapAllocation の場合、ハンドルはPROCESS_VM_READで開き、アクセス権をPROCESS_QUERY_INFORMATIONする必要があります。

ResourceType が AvrfResrouceHeapAllocation で、Flags パラメーターにAVRF_ENUM_RESOURCES_FLAGS_SUSPENDが含まれている場合は、PROCESS_SUSPEND_RESUME フラグも使用する必要があります。

Flags

ResourceType が AvrfResourceHandleTrace の場合、フラグは定義されておらず、Flags パラメーターの値は 0 である必要があります。

ResourceType パラメーターが AvrfResourceHeapAllocation の場合、Flags パラメーターは 0 または次の値の組み合わせにすることができます。

値	意味
AVRF_ENUM_RESOURCES_FLAGS_DONT_RESOLVE_TRACES	ヒープ割り当てのスタックバックトレースが存在する場合、ReturnAddresses 配列にコピーされません。これにより、列挙プロセスが高速化される可能性があります。
AVRF_ENUM_RESOURCES_FLAGS_SUSPEND	ヒープ割り当て列挙が実行される前に、プロセスが中断されます。これにより、ヒープの変更が列挙に影響を与える可能性が最小限に抑えられます。

ResourceType

このパラメーターには、次のいずれかの値を指定できます。

値	意味
AvrfResourceHandleTrace	API は、現在のプロセスのハンドルテーブルからハンドルに対して最後に保存された操作を列挙します。
AvrfResourceHeapAllocation	API は、ヒープメタデータブロックを含むヒープ割り当てを列挙します。