Macro CheckPointer
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
Verifica se um ponteiro é NULL. Se o ponteiro for NULL, a função ou o método no qual a macro aparece retornará o valor especificado.
Sintaxe
HRESULT CheckPointer(
p,
ret
);
Parâmetros
-
p
-
Ponteiro para marcar.
-
Ret
-
Valor que a função ou o método retorna se p for NULL.
Retornar valor
A função ao redor retornará ret se p for NULL. Caso contrário, a macro não fará com que a função ao redor retorne.
Exemplos
HRESULT MyFunction(VOID *pSomeParameter)
{
// Return E_INVALIDARG if pSomeParameter is NULL.
CheckPointer(pSomeParameter, E_INVALIDARG)
// Rest of the function (not shown).
}
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|