XMemGetWriteWatch
Recupera o endereço das páginas que foram gravadas em um intervalo de endereços virtuais.Sintaxe
Parâmetros
dwFlags _In_Tipo: DWORD Indica se o estado de rastreamento de gravação é redefinido após a chamada para XMemGetWriteWatch. Especifique
WRITE_WATCH_FLAG_RESET para sinalizar que o rastreamento de gravação deve ser redefinido. Caso contrário, especifique 0.
lpBaseAddress _In_Tipo: PVOID O endereço base do intervalo para o qual as informações de rastreamento de gravação serão recuperadas. dwRegionSize _In_
Tipo: SIZE_T O tamanho do intervalo para o qual as informações de rastreamento de gravação serão recuperadas. lpAddresses _Out_writes_to_opt_(*lpdwCount,*lpdwCount)
Tipo: PVOID Um ponteiro para um buffer que recebe uma matriz dos endereços das páginas gravadas no intervalo de endereços. lpdwCount _Inout_opt_
Tipo: ULONG_PTR* Na entrada, fornece a contagem de elementos da matriz em lpAddresses.
Na saída, contém o número de elementos da matriz retornados. lpdwGranularity _Out_opt_
Tipo: LPDWORD Um ponteiro para uma variável que recebe o tamanho da página, em bytes.
Valor retornado
Tipo: UINT Em caso de êxito, XMemGetWriteWatch retorna 0. Se a função falhar, o valor retornado será diferente de zero.Comentários
XMemGetWriteWatch é substancialmente semelhante a GetWriteWatch na operação normal. No entanto, como as capturas de GPU do PIX também exigem rastreamento de gravação, XMemGetWriteWatch tem um comportamento adicional quando ocorrem capturas de GPU do PIX. Quando ocorre uma captura de GPU do PIX, o rastreamento de gravação é suspenso para o título. Isso é indicado pelo retorno deERROR_CAN_NOT_COMPLETE por XMemGetWriteWatch. Esse valor continuará sendo retornado por XMemGetWriteWatch até que seja feita uma chamada para XMemResumeWriteWatch (após a conclusão da captura de GPU) indicando que o chamador está pronto para retomar o rastreamento de gravação. O estado de rastreamento de gravação é desconhecido para todos os intervalos de endereços virtuais MEM_WRITE_WATCH após a conclusão de uma captura de GPU do PIX. É responsabilidade do chamador restabelecer uma expectativa de linha de base do estado de rastreamento de gravação de cada intervalo que está sendo monitorado. Isso pode ser feito chamando XMemResetWriteWatch, XMemGetWriteWatch com WRITE_WATCH_FLAG_RESET ou gravando intencionalmente nas regiões MEM_WRITE_WATCH.