PFND3DDDI_UNLOCK função de retorno de chamada (d3dumddi.h)
A função Desbloquear desbloqueia um recurso ou uma superfície dentro do recurso que foi bloqueado anteriormente pela função Lock.
Sintaxe
PFND3DDDI_UNLOCK Pfnd3dddiUnlock;
HRESULT Pfnd3dddiUnlock(
HANDLE hDevice,
const D3DDDIARG_UNLOCK *unnamedParam2
)
{...}
Parâmetros
hDevice
Um identificador para o dispositivo de exibição (contexto gráfico).
unnamedParam2
pData [in]
Um ponteiro para uma estrutura de D3DDDIARG_UNLOCK que descreve o recurso ou a superfície dentro do recurso a ser desbloqueado.
Valor de retorno
Desbloqueio retorna um dos seguintes valores:
| Código de retorno | descrição |
|---|---|
| S_OK | O recurso é desbloqueado com êxito. |
| E_OUTOFMEMORY | O desbloqueio não pôde alocar a memória necessária para que ela fosse concluída. |
| E_INVALIDARG | O recurso que D3DDDIARG_UNLOCK descreve não foi bloqueado por uma chamada anterior para a função de bloqueio de do driver. |
Observações
Esses comentários são análogos à descrição na seção Comentários da página de referência do Lock.
O driver de exibição do modo de usuário deve chamar a função de pfnUnlockCb do runtime do Microsoft Direct3D após de desbloqueio ser chamado. Neste chamada pfnUnlockCb, o driver de exibição no modo de usuário passa um identificador de alocação. Antes de chamar pfnUnlockCb, o driver de exibição do modo de usuário deve primeiro mapear a superfície para uma alocação apropriada.
O runtime chama a função Desbloquear do driver de exibição do modo de usuário para desbloquear superfícies de memória do sistema pré-alocadas também. O runtime define o sinalizador NotifyOnly campo de bits no Flags membro da estrutura de D3DDDIARG_UNLOCK que é apontado por pData para diferenciar desbloqueio chamadas que desbloqueiam a memória preallocada do sistema de outras chamadas de desbloqueio de. Se a função Lock do driver de exibição do modo de usuário chamada pfnLockCb para bloquear a alocação de memória do sistema que corresponde à superfície, ela também deverá chamar pfnUnlockCb. Não chamar pfnUnlockCb interrompe a coordenação entre o runtime, o driver de exibição do modo de usuário e o driver de miniporto de exibição.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Universal |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |