DXGKDDI_RELEASESWIZZLINGRANGE função de retorno de chamada (d3dkmddi.h)
A função DxgkDdiReleaseSwizzlingRange libera um intervalo de giros que a função DxgkDdiAcquireSwizzlingRange configurada anteriormente.
Sintaxe
DXGKDDI_RELEASESWIZZLINGRANGE DxgkddiReleaseswizzlingrange;
NTSTATUS DxgkddiReleaseswizzlingrange(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RELEASESWIZZLINGRANGE pReleaseSwizzlingRange
)
{...}
Parâmetros
[in] hAdapter
Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX na função MiniportDeviceContext da função DxgkDdiAddDevice.
[in] pReleaseSwizzlingRange
Um ponteiro para uma estrutura de DXGKARG_RELEASESWIZZLINGRANGE que contém informações para liberar o intervalo de swizzling.
Valor de retorno
DxgkDdiReleaseSwizzlingRange retorna STATUS_SUCCESS ou um resultado de erro apropriado se o intervalo de swizzling não for liberado com êxito.
Observações
A função DxgkDdiReleaseSwizzlingRange normalmente é chamada quando a alocação especificada (ou seja, o hAllocation membro da estrutura DXGKARG_RELEASESWIZZLINGRANGE à qual o parâmetro pReleaseSwizzlingRange aponta para) é removido ou destruído ou quando outra alocação requer o intervalo de swizzling que o RangeId membro do DXGKARG_RELEASESWIZZLINGRANGE especifica.
Se a alocação especificada estiver atualmente associada a vários intervalos de swizzling (por meio de chamadas para a função DxgkDdiAcquireSwizzlingRange), o driver de miniporto de exibição deverá liberar apenas o intervalo de giros que o RangeId membro do DXGKARG_RELEASESWIZZLINGRANGE especificar. Se o driver de miniporto de exibição liberar todos os intervalos de swizzling associados à alocação, a corrupção aleatória na alocação poderá resultar porque um aplicativo pode estar usando um ou mais dos intervalos de swizzling no momento.
O driver deve usar OM (E/S) mapeado pela memória para configurar um intervalo de swizzling. Esses acessos de intervalo giratório não devem interferir na execução da GPU (ou seja, a GPU não deve ficar ociosa quando DxgkDdiReleaseSwizzlingRange for chamado).
Todas as chamadas para DxgkDdiReleaseSwizzlingRange são serializadas entre si, mas não com nenhuma outra função DDI (interface de driver de dispositivo).
DxgkDdiReleaseSwizzlingRange deve ser tornada paginável.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |