DXGKCB_AGP_SET_COMMAND função de retorno de chamada (dispmprt.h)
A função AgpSetCommand define a taxa de AGP e especifica se o endereçamento de banda lateral e transações de gravação rápida estão habilitados.
Sintaxe
DXGKCB_AGP_SET_COMMAND DxgkcbAgpSetCommand;
NTSTATUS DxgkcbAgpSetCommand(
[in] HANDLE Context,
[in] ULONG Command
)
{...}
Parâmetros
[in] Context
Um identificador para um bloco de contexto associado a uma interface AGP. O driver de miniporto de exibição recebeu anteriormente esse identificador no Context membro da estrutura DXGK_AGP_INTERFACE que foi preenchida por DxgkCbQueryServices.
[in] Command
Um conjunto de sinalizadores que especificam a taxa de AGP e os tipos de transações de AGP que serão usadas.
O chamador deve definir um e apenas um dos sinalizadores a seguir.
| de Sinalizador | significado |
|---|---|
| DXGK_AGPCOMMAND_AGP1X | A taxa de transferência do AGP é 1X. |
| DXGK_AGPCOMMAND_AGP2X | A taxa de transferência do AGP é 2X. |
| DXGK_AGPCOMMAND_AGP4X | A taxa de transferência do AGP é 4X. |
| DXGK_AGPCOMMAND_AGP8X | A taxa de transferência do AGP é 8X. |
O chamador também pode optar por definir ou limpar os sinalizadores a seguir.
| de Sinalizador | significado |
|---|---|
| DXGK_AGPCOMMAND_DISABLE_SBA | Se esse sinalizador estiver definido, o endereçamento de banda lateral será desabilitado. Se esse sinalizador estiver limpo, o endereçamento de banda lateral estará habilitado. |
| DXGK_AGPCOMMAND_DISABLE_FW | Se esse sinalizador estiver definido, as transações de gravação rápida serão desabilitadas. Se esse sinalizador estiver limpo, as transações de gravação rápida serão habilitadas. Observe que as transações de gravação rápida não podem ser usadas com o AGP1X. |
Valor de retorno
AgpSetCommand retornará STATUS_SUCCESS se tiver êxito. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.
Observações
Nenhum.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dispmprt.h (inclua Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |