ISpPhrase::GetSerializedPhrase
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método obtém as informações frase em um serializado forma. Isso permitiria que o cliente, de exemplo, para salvar a estrutura frase para um arquivo e restaurar posterior-lo por chamado ISpPhraseBuilder::InitFromSerializedPhrase.
O chamador passa o endereço de um ponteiro que é inicializado para apontar para um bloco de memória que é alocada usando:: CoTaskMemAlloc. É responsabilidade do chamador para chamar:: CoTaskMemFree para livre neste objeto. A estrutura recuperada é definida para ser um SPSERIALIZEDPHRASE. No entanto, o real tamanho do bloco está contido em (* ppCoMemPhrase)-> ulSerializedSize. Esse tamanho inclui o tamanho da estrutura de SPSERIALIZEDPHRASE.
Um aplicativo que não precisarão reconhecimento alternativas ou áudio retido pode, e quiser salvar espaço, pode desejar para serializar apenas as informações frase (para exemplo, texto frase, Nome da regra, identificador mecanismo SR e SO On.).
Syntax
HRESULT GetSerializedPhrase(
SPSERIALIZEDPHRASE** ppCoMemPhrase
);
Parameters
- ppCoMemPhrase
[out] Endereço de um ponteiro para um SPSERIALIZEDPHRASE estrutura contendo o serializado frase dados.
Return Value
A seguinte tabela mostra os valores possíveis de retorno.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_POINTER |
ppCoMemPhrase é inválido ou incorreto; |
SPERR_UNINITIALIZED |
Frase é não inicializado. |
E_OUTOFMEMORY |
Disponível excedido memória. |
Example
O seguinte trecho de código ilustra o uso esse método como herdadas ISpPhrase para serializar apenas a parte frase de um objeto resultado.
HRESULT hr = S_OK;
// ... obtain a recognition result object from the recognizer...
SPSERIALIZEDPHRASE* pSerializedPhrase = NULL;
// get the recognized phrase object
hr = cpRecoResult->GetSerializdPhrase(&pSerializedPhrase);
// Check hr
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |